Download the PHP package robertboloc/rbcomment without Composer

RbComment

Zend Framework 2 module for drop-in, self-hosted comments, with email notifications, Akismet, ZfcUser and Gravatar integration.

Table of contents

• Installation
• Usage
• Themes
• Configuration
• CLI
• Roadmap
• Notes

Installation

1. Add the module key to your composer.json file

2. Run composer update

3. Import the schema from data/schema.sql into your database.

4. Add the new module to your application's modules list in config/application.config.php

Usage

In your views use the rbComment helper to display the count, the list and a form for adding new comments. Invoke it where you want your comments box to appear. Simple isn't it? This helper can be used in any view.

The $theme parameter is used to specify the theme of the comments box (if none is specified default is used).

Currently, the module is designed to allow only one comment box per page, as it uses the page uri to identify a thread.

Themes

The module comes with 2 themes for now. To implement new ones create a new partial using as base the existing ones.

Use your new theme calling $this->rbComment('yourpartial')

The current themes (and possible values of the $theme parameter if not using a custom partial) are :

default

Basic theme with no external dependencies. Contains the minimum styling to make it look decent.

uikit

This theme requires the UIkit CSS framework. Use this theme if your project is based on the UIkit framework.

bootstrap3

This theme requires the Bootstrap v3.x.x CSS framework. Use this theme if your project is based on the Bootstrap framework, version 3.

Configuration

The default configuration of the module can be found in the file config/module.config.php. To override the defaults, add your values under the rb_comment key in the config/autoload/local.php file of your application, using the same structure as in the defaults.

Currently the configurable parameters are:

default_visibility

This parameter controls the visibility of the newly published comments. If set to 1 all new published comments will be visible. If 0 they will not be shown. This is useful for moderation.

strings

This array contains the translations for the strings used in the comments box. To change or translate to another language override these values with your own.

email

This array contains email notifications parameters

For sending the emails the module uses a service factory called RbComment\Mailer. As a default it configures a sendmail transport. This should be changed in production and customized to your needs (probably with smtp). To do this rewrite the service factory RbComment\Mailer.

akismet

The module provides integration with the Akismet service. Comments marked as spam will be hidden (not deleted) and no notification will be sent. To use this feature the following params must be configured:

zfc_user

By default the ZfcUser integration is disabled. To use it you must update this flag in your config file.

gravatar

By default the Gravatar integration is disabled. To use it you must update this flag in your config file.

CLI

The following cli commands are available:

delete spam Delete all comments marked as spam from the database

This can be added to your cron to periodically remove spam from the database and keep your tables clean and light.

Roadmap

If you want to contribute to the development of this module and don't know where to start you can pick one of this tasks :

• Allow multiple instances of the comments box on the same page
• Use AJAX for storing/retrieving comments
• Emoji integration
• Block spammers by IP
• More themes

Notes

• If you are using the BjyAuthorize module (or any other route restricting module) make sure the route rbcomment is publicly accessible.

• This module assumes you have a database adapter configured.