Custom Themes

The plugin works out of the box with x3 and Paper Lantern-based themes. However, if you need to use custom themes, these can be supported too.

Setup

First, navigate to your theme directory. This will usually be located in /usr/local/cpanel/base/frontend/, e.g.

cd /usr/local/cpanel/base/frontend/mycoolskin

and symlink the plugin directory:

ln -s /usr/local/cpanel/base/frontend/paper_lantern/letsencrypt

Modifications

You should be able to access the plugin while using the theme now, but it will be fairly unstyled.

In the /usr/local/cpanel/base/frontend/paper_lantern/letsencrypt directory, you will find a number of ‘vendor’ HTML files, e.g.:

vendor_error.html  vendor_reinstall.html  vendor_settings.html                    vendor_theme_x3_header.html
vendor_home.html   vendor_remove.html     vendor_theme_paper_lantern_header.html  vendor_view.html
vendor_issue.html  vendor_result.html     vendor_theme_x3_footer.html

To modify the header, for example, you will need to copy vendor_theme_paper_lantern_header.html to custom_theme_{name}_header.html, e.g. custom_theme_mycoolskin_header.html.

The custom_theme_ files will be used if they exist, instead of the vendor_ files.

In most cases you will only need to apply customisation to the header and optionally the footer templates.