Documentation

Integration

Once the script installation is complete you will need to add the script to your page(s). To do this you will need at least one file to add the script to. You may already have this file existing somewhere on your site, perhaps it's an article that you have written or some other useful information. If you don't then you will need to create one now. Once you know which file to add the script to, move onto the steps below. The file should ideally be a PHP file. If it's a HTML file then read the FAQ section of the site.

In the package you downloaded, there is an example.php file which you can look at.

Step One

The first step for integration is to add the following line to the very top of the file. It is necessary for session-dependant features to work. By first line, this means even above the <!DOCTYPE html> and <html> line. If you already have this then there is no need to add it again.

<?php session_start(); ?>

Step Two

Next you need to add the following two lines inside the HTML head tag of the file. The first line declares the UTF-8 charset which means that foreign characters can be displayed. If you have the 'ISO-8859-1' charset tag, or any other charset tag, please remove it and replace it with this UTF-8 one. The second line makes the page responsive to it can be viewed on mobiles and tablets. If you already have these lines then there is no need to add them again.

<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">

Step Three

The last part is the code to actually display the comments and the comment form. This should be added somewhere in your HTML body tag, wherever you want the comments to be shown.

The identifier can contain any value. Just make sure that it's unique to each page that you add the script to.

The reference should be a short descriptive term of the page. It is shown to your visitors. Using the heading of the page is typically a good idea.

The folder is the name of the /upload/ folder that you renamed in step three of the installation guide. Make sure it starts and ends in a forward slash.

There is never any need to edit the last line.

<?php
$cmtx_identifier = '1';
$cmtx_reference  = 'Page One';
$cmtx_folder     = '/upload/';
require($_SERVER['DOCUMENT_ROOT'] . $cmtx_folder . 'frontend/index.php');
?>