Template Files for Client Zone

MDJM utilises template files to deliver the content for all pages within the Client Zone. Whilst these templates work out of the box following installation of MDJM, it is possible to customise each and every Client Zone page to better fit in with the design of your website.

Any changes that you make, so long as you apply them to a child theme, will not be overwritten when the MDJM plugin is updated, or your theme is updated.

Template File Locations

Before displaying content on a Client Zone page, MDJM searches three locations (by default) for template files. The first location within which the required file is found, the search stops and the content from that template is used.

MDJM Searches in the following locations in the following order…

1. A folder called mdjm-templates within your child theme directory for your currently active theme
2. A folder called mdjm-templates within your currently active theme’s directory
3. The default templates folder within the MDJM plugin directory (mobile-dj-manager/templates)

Under the templates directory is a list of sub-directories which refer to the page within which its content is displayed. For some pages there may be multiple template files for different sections or visitors etc.

Child Theme Templates Directory

Theme Template Directory

Templates Directory

Copying Template Files

You should not customise any of the default template files provided with MDJM. Instead, copy the required file(s) to an mdjm-templates directory within your theme or as recommended, child theme whilst maintaining the folder structure provided in the default location. For example to customise the playlist-client.php template file for your Twenty Sixteen child theme, you would copy the file to
/wp-content/themes/twentysixteen-child/mdjm-templates/playlist/playlist-client.php and then apply your customisations there.

Note that as soon as you copy the file to your [child] theme directory, it becomes active and will be used by MDJM to deliver content.

Under the root of the default templates folder is a style sheet, mdjm.css. To make css changes, you should copy this file to the root of your new mdjm-templates folder.

Customising Templates

All templates can be fully customised and provide full support for all MDJM content tags allowing you to provide dynamic content (such as event date) to each of your clients. Content tags should be entered in the format {event_date}.

When editing templates, be sure to keep any field names the same as the default template file to ensure that data is captured and saved correctly.

You will also notice that within the default templates, much of the text is wrapped in PHP code. You can safely remove this code and replace it with custom text without causing any issues. PHP is only used to allow WordPress to translate the text if necessary.

Video Demonstration