Table of Contents

If you want to change a page layout, the templates of interest are:

     Comments display (driver script: comments-display-prep.php)
        comments-display-tpl.php
        comments-form-tpl.php
		 
     Comment edit (driver script: comments-edit-prep.php)
        comments-edit-tpl.php
        comments-edit-form-tpl.php
		
     Comment reply (driver script: comments-reply-prep.php)
        comments-reply-tpl.php
        comments-form-tpl
		
     Comment preview: comments-preview.php
		
     Comment help: comments-help.php

     Messages: message-panel.php

The driver scripts do not directly affect the page presentation. But in some cases they do construct some of the HTML elements used in the templates. For example, comments-display-prep.php assigns the class name to comment entries. It also creates the HTML for the reply, edit and delete links.

Unless you are experienced in PHP programing you should not attempt to change anything in the driver scripts. Confine yourself to rearranging the placement of elements on a page and the styles used by the elements.

Instead of changing the default templates, I recommend that you copy and rename the template. Doing so will ensure that changes you make will not be overwritten by future releases of TalkBack. Example names:

   my-comments-display-tpl.php
   comments-display-tpl-custom.php

Instruct the system to use the different template by changing the template file name in the configuration settings.

Finally, document your changes. Write down in detail what you changed and keep the document in a safe place to refresh your memory in the future.

If you are experienced with PHP and want to look "inside" TalkBack, look at comments.php. That will give you the sequence of calls for each type of action and allow you to navigate through the scripts.