Documentation

Building a website with Chap is intended to be as simple as possible, only using powerful shortcodes and flexible theme options. No need to manually edit files or deal with complicated page builders.

Child theme file hierarchy
lib
template-functions
Copy files from parent theme here to override template functions.
widgets
Copy files from parent theme here to customize widgets or create filters for new ones.
semantic-ui
Override Semantic UI variables and components.
templates
Copy partial templates from parent theme here to modify and override them.
functions.php
Theme functions file, loaded before parent theme. Can be used to hook into filters and actions.
screenshot.png
Child theme’s screenshot, displayed on the theme select page.
scripts.js
Child theme JavaScript file, can be used to add custom scripts.
style.css
Child theme header file, can be used to add custom styles.
template-*.php
Create custom page templates.
*.php
Copy base templates from parent theme here to modify and override them.
Most of the PHP code in Chap is namespaced, so make sure to use namespaced functions and classes.
Parent theme file hierarchy

functions.php is used to include files from the lib/ directory which contains all of the theme functionality. Don’t place any custom code in this file — use the functions.php in the child theme folder for custom modifications.

amp
Contains AMP templates and styles.
dist
Contains minified theme assets. Nothing in this folder should be manually edited.
lang
Contains the .pot file. Translation files should be placed here.
lib
Contains the theme’s code library.
3rd-party
Contains all third party libraries.
admin
WordPress admin dashboard functionality.
options
Theme options.
semantic-ui
Semantic UI LESS source, used to compile the CSS.
shortcodes
WordPress shortcode overrides.
template-functions
Functions used to render page content.
walkers
Custom walkers.
widgets
Widget filters.
woocommerce
WooCommerce modifications.
templates
Contains the theme’s partial templates.
woocommerce
Contains WooCommerce templates overrides.
404.php
Error 404 page template.
base.php
The base template for every page displayed.
functions.php
Theme library entry point, used to include all dependencies.
index.php
Archives base template, used by blog page, category archives, author archives.
page.php
Pages base template. Custom templates can be created based on this.
screenshot.png
Theme’s screenshot, displayed on the theme select page.
search.php
Search results page base template.
searchform.php
Search form template, used by Search Widget or included directly.
single.php
Single post base template.
style.css
Theme header file, not used for actual styles.
template-*.php
Custom page templates.

Once you’ve installed and activated the theme you will be presented with a setup wizard which automatically installs the required plugins and sets up your default content.

Required plugins
Chap Shortcodes
Contains the shortcodes created for this theme.
Envato Market
Used to keep your theme updated.
One Click Demo Import
Used to easily import demo sites.
Embedded plugins
Titan Framework
Used to manage Chap theme options.
Widget Output Filters
Used under the hood to make WordPress widgets compatible with Semantic UI.