Using Themes

Note that we refer to “ClassicPress Themes” in this document, however you can also use WordPress themes with the ClassicPress CMS.

Currently, the default Theme Directory (also called repository) that you can access in the ClassicPress Dashboard in fact only shows WordPress themes. You can use them, but you must be sure that they are compatible with WordPress 4.9, and regularly check that they still are compatible.

Depending on the Requires at least header in the theme’s style.css file a notice will be displayed, in case a theme is not compatible.

With the ClassicPress Directory Integration plugin you get access to themes that are 100% built for ClassicPress.

As ClassicPress grows, Developers do and will continue to add themes to the ClassicPress Theme Directory that are designed to work With ClassicPress.

What is a Theme?#Link to this section

Fundamentally, the theme system is a way to control the Design and Appearance of your ClassicPress site. Themes can provide much more control over the visual presentation of your content and other data on your ClassicPress site, as well as behaviour of certain site’s elements while interacting with visitors.

A theme is a collection of files that work together to produce a graphical interface with an underlying unifying design for a website. These files are called template files. A theme modifies the way the site is displayed, without modifying the underlying software. Themes may include customized template files, image files (*.jpg, *.png, *.gif), style sheets (*.css), custom pages, as well as any necessary code files (*.php).

Let’s say you write a lot about Bread and Wine. Through the use of the ClassicPress Loop and template files, you can customize your Wine category posts to look different from your Bread category posts. With this powerful control over what different pages and categories look like on your site, you are limited only by your imagination. For information on how to create custom look for various templates in your theme, take a look at the Template Hierarchy.

Default Themes#Link to this section

ClassicPress currently comes with 3 themes (of which 1 child theme).

• The ClassicPress Theme, our default theme.
• The TwentySeventeen theme, a for ClassicPress modified version of the WordPress TwentySeventeen theme.
• The ClassicPress TwentySeventeen theme, a child theme of the WordPress TwentySeventeen theme.

The ClassicPress TwentySeventeen child theme was created for preserving the ClassicPress copyright in the footer and for other personal modifications to the WordPress TwentySeventeen theme.

From ClassicPress 3.0 the ClassicPress TwentySeventeen child theme will be removed in favour of our modified version of the the TwentySeventeen theme.

You can switch between themes from the Appearance menu in the Administration Screen.

With the ClassicPress Directory Integration plugin you get access to themes that are 100% built for ClassicPress. They will appear in the Appearance > Install CP Themes screen.

WordPress themes you add to the Theme Directory will appear in the Administration Screen > Appearance > Themes as additional selections.

Get New Themes#Link to this section

Every theme in the ClassicPress and WordPress Theme Directory is reviewed by a dedicated team and tested against wide range of rules, all of which are ensuring secure and pleasant experience for theme user.

The ClassicPress community recommends to use ClassicPress themes, and/or to develop your own theme, made for ClassicPress.

Keep in mind that reviewers of WordPress themes do not test their themes with ClassicPress. It is up to you to ensure those themes works with ClassicPress (WordPress 4.9) and to keep yourself updated with the ongoing development work done on the theme you choose.

When choosing a theme from the WordPress Theme Directory you must make sure you are not installing a theme that uses any Blocks or some of the newer WordPress features like Patterns and Templates. Those will not work in ClassicPress

Unfortunately the WordPress Theme Directory does not stop any theme from showing up in your Themes screen on a ClassicPress Install, even if that theme is not compatible with ClassicPress or WordPress 4.9. Depending on the Requires at least header in the theme’s style.css file a notice will be displayed, in case a theme is not compatible. But it is best practice to navigate to the specific WordPress Theme Directory page, in order to find its minimal requirements and ensure that it will work with ClassicPress.

Theme Compatibility#Link to this section

As mentioned above, themes requiring a WordPress version above 4.9 are considered incompatible with ClassicPress, even if they might work. When ClassicPress updates, it is less of a risk than with WordPress because ClassicPress follows SemVer and will never break backwards compatibility as long it updates within a minor or patch release. If ClassicPress updates to a major release, it might break Backwards Compatibility and themes should be carefully tested before used.

This is what will be displayed if the theme does not work with WordPress 4.9 and thus is not compatible with ClassicPress:

Adding New Themes#Link to this section

Most of themes come with installation instructions, especially the ones that may require more steps than the usual theme installation. Be sure to read through and follow those instructions for the successful installation of the theme. If your theme does not work after following any provided instructions, please make sure it is supposed to work with ClassicPress or WordPress 4.9, and contact the theme author for help.

Adding New Themes using the Administration Screens#Link to this section

You can download any theme from the ClassicPress and WordPress Theme Directory directly to your site via the Appearance sub-menu.

For ClassicPress Themes:
(this requires the ClassicPress Directory Integration plugin to be installed)

• Log In to your ClassicPress Administration Area.
• Select the Appearance screen, then Install CP Themes.
• Either use the Search option or scroll through the pages to locate a theme you would like to use.
• Click on the More Details link for more theme info or the Install link to upload the theme to your site.

For WordPress Themes:

• Log In to your ClassicPress Administration Area.
• Select the Appearance screen, then Themes.
• Select Add New.
• Either use the Search or Filter options to locate a theme you would like to use.
• Click on the Preview link to preview the theme or the Install link to upload the theme to your site,

Or use the Upload Theme button at the top of page to upload a zipped copy of a theme that you have previously downloaded to your machine. This way you can also upload themes that are not stored on the ClassicPress or WordPress Theme Directory.

Install New Theme#Link to this section

When the theme is already downloaded but not activated Live Preview option will give you a preview of your site with your own, existing content.

Adding New Themes Manually (FTP)#Link to this section

To add a new theme to your ClassicPress installation via FTP protocol, you’ll need an FTP client and extracted theme files.

• Download the theme archive (.zip) and extract the files it contains. You should have a folder named as theme itself, containing theme files.
• Using an FTP client to access your host web server and navigate to /wp-content/themes/ directory.
• Upload the theme folder to this directory on your host server.
• Follow the instructions below for activating the new theme.

Activating the Theme#Link to this section

Now that new theme is in the /wp-content/themes/ directory (whether you used Administration Screens or FTP method), this new theme is ready to be activated. All themes in the /wp-content/themes/ directory are available for Activation and Update (when update is provided by theme author), but only one theme from this directory can be Active.

When theme is Activated it means that this theme’s style and functionality (look and behavior) will be applied on your site. You will be informed by Administration notification about successful activation of the theme.

To activate a theme for your site:

• Log in to the ClassicPress Administration Area.
• Select the Appearance screen, then Themes.
• You should see here all themes from your /wp-content/themes/ directory and from here you can see details for each of them by clicking on Theme Details (rollover the theme thumbnail).
• Live Preview option will give you preview of your site with your site’s content.
• To activate the theme click the Activate button.
• Your selection will immediately become active.

Note: If the theme preview is blank, do NOT activate the new theme without investigating further. Your site may not be displayed correctly, otherwise. If you do not see theme’s thumbnail at all, your new theme might be corrupted or broken. Take a look below installed theme’s thumbnails if there is any info about broken themes. In this case contact the theme author for help.

Creating Themes#Link to this section

If you are interested in creating your own theme for distribution, or learning more about the architecture of themes, there are several resources where to start.

1. The WordPress Theme Handbook.
   Keep in mind that this is a not ClassicPress Focused Documentation and there might be details documented that are invalid for ClassicPress.
2. The ClassicPress Code Reference.
3. The ClassicPress Developer Guides.
4. The ClassicPress Theme Guidelines.
5. The ClassicPress Programming Forum.
6. The ClassicPress Themes Forum.
7. The ClassicPress Themes Zulip channel.

If you simply want to customize your current theme for your own use, consider using a child theme. The ClassicPress CMS already comes with a TwentySeventeen child theme bundled, for an easy and fast kickstart of your development work. Detailed information can be found in the WordPress Theme Handbook.