mirror of
https://github.com/silverstripe/silverstripe-comments
synced 2024-10-22 11:05:49 +02:00
49 lines
2.1 KiB
Markdown
49 lines
2.1 KiB
Markdown
# Installation
|
|
|
|
To begin the installation first download the module from online. You can find what version
|
|
you require for your SilverStripe installation on the silverstripe.org website.
|
|
|
|
After you have finished downloading the file, extract the downloaded file to your sites root
|
|
folder and ensure the name of the module is `comments`.
|
|
|
|
Run a database rebuild by visiting *http://yoursite.com/dev/build*. This will add the required database
|
|
columns and tables for the module to function.
|
|
|
|
If you previously had SilverStripe 2.4 installed then you will also need to run the migration script
|
|
provided. More information on this is in the next section
|
|
|
|
## Enabling Commenting
|
|
|
|
Out of the box the module adds commenting support to all pages on your site. This functionality can be
|
|
turned on and off on a per page basis in the CMS under the `Behaviour` tab for a given page. Once the `Allow Comments`
|
|
checkbox is ticked republish the page and view the webpage.
|
|
|
|
Ensure that your template file (usually themes/yourtheme/templates/Layout/Page.ss) has the `$CommentsForm` variable
|
|
where you want comments to appear.
|
|
|
|
To enable commenting on other objects (such as your own subclasses of DataObject) add the following
|
|
to your `mysite/_config.php` file.
|
|
|
|
// Adds commenting to the class SiteTree (all Pages)
|
|
Commenting::add('SiteTree');
|
|
|
|
You can also pass configuration options to the add function to customize commenting on that object. Again
|
|
in your `mysite/_config.php` file replace the previous line with the following
|
|
|
|
// Adds commenting to the class SiteTree (all Pages) but require the user to login and comments
|
|
// are moderated
|
|
Commenting::add('Foo', array(
|
|
'require_moderation' => true,
|
|
'require_login' => true
|
|
));
|
|
|
|
For more configuration options see [Configuration](Configuration.md).
|
|
|
|
## Upgrading
|
|
|
|
### Migrating from 2.* SilverStripe installations
|
|
|
|
This module replaces the built in commenting system available in versions up to SilverStripe 2.4. To migrate from
|
|
that you need to run `dev/build` after installing the module.
|
|
|
|
You can do this via sake (`sake dev/build`) or via a web browser by visiting http://yoursite.com/dev/build |