Skip to content
This repository has been archived by the owner on Aug 7, 2018. It is now read-only.

seothemes/child-theme-library

Repository files navigation

Child Theme Library

WordPress License

Note: This project is no longer maintained. Please use d2/core instead.

A config-based composer package that provides a set of modules to extend Genesis child theme development.

Description

The main purpose of the Child Theme Library is to provide a shareable codebase for commercial Genesis child themes. This is achieved by using configuration-based architecture to separate the theme's reusable logic from it's configuration. Using this approach, we are able to use a single codebase which can be heavily customized by passing in different configs. This project is inspired by the Genesis Theme Toolkit by Gary Jones, but contains additional functionality specific to commercial themes, including support for older versions of PHP. See the Genesis Starter Theme as an example.

Requirements

Requirement How to Check How to Install
PHP >= 5.4 php -v php.net
WordPress >= 4.8 Admin Footer wordpress.org
Genesis >= 2.6 Theme Page studiopress.com
Composer >= 1.5.0 composer --version getcomposer.org
Node >= 9.10.1 node -v nodejs.org
NPM >= 5.6.0 npm -v npm.js
Yarn >= 0.2.x yarn -v yarnpkg.com
Gulp CLI >= 1.3.0 gulp -v gulp.js
Gulp = 3.9.1 gulp -v gulp.js

Installation

Include the package in your child theme's composer.json file (an example composer.json file can be found here).

composer require seothemes/child-theme-library

Optionally install the TGMPA composer package:

composer require tgmpa/tgm-plugin-activation

Usage

There are three steps to include the Child Theme Library in your project:

  • Include the Composer autoload.php file
  • Store the library as a global variable for use throughout your theme
  • Initialize the child theme library

All changes to the child theme should be made via the theme configuration file. An example config can be found here.

The following is an example of how to achieve the steps mentioned above. This code should be placed in your functions.php file, before any custom code is loaded:

if ( file_exists( __DIR__ . '/vendor/autoload.php' ) ) {

	require_once __DIR__ . '/vendor/autoload.php';
	$child_theme = new SEOThemes\ChildThemeLibrary\Theme();
	$child_theme->init();

}

Storing the Child Theme Library object as a global variable provides access to the library's public properties and methods. For example, to print the name of the theme you can do the following:

echo $child_theme->name;

Or, to use the Minify CSS helper function:

$css = 'body { background-color: red; }';
echo $child_theme->utilities->minify_css( $css );

Structure

The Child Theme Library follows the PHP Package Development Standard folder structure and uses PSR-4 Autoloading.

./
├── docs/
│   └── example-config.php
├── src/
│   ├── Admin.php
│   ├── Attributes.php
│   ├── Customizer.php
│   ├── Defaults.php
│   ├── DemoImport.php
│   ├── Enqueue.php
│   ├── HeroSection.php
│   ├── Layout.php
│   ├── Markup.php
│   ├── Plugins.php
│   ├── Setup.php
│   ├── Shortcodes.php
│   ├── Structure.php
│   ├── Templates.php
│   ├── Theme.php
│   ├── Utilities.php
│   └── WidgetsAreas.php
├── tests/
├── .editorconfig
├── .gitattributes
├── .gitignore
├── composer.json
├── phpcs.xml
├── CHANGELOG.md
├── CONTRIBUTING.md
├── LICENSE.md
└── README.md

Hooks

Name Type Description
child_theme_after_title_area action Runs after the title area
child_theme_hero_section action Runs during the hero section
child_theme_front_page_widgets action Runs during the front page loop
child_theme_constants filter Filters the array of constants
child_theme_config filter Filters the path to the config
child_theme_latest_posts_title filter Filters the latest posts title
child_theme_latest_posts_excerpt filter Filters the latest posts excerpt
child_theme_footer_backtotop filter Filters the backtotop shortcode

Support

Please visit https://github.com/seothemes/child-theme-library/issues/ to open a new issue.

License

This project is licensed under the GNU General Public License - see the LICENSE.md file for details.

Authors

See also the list of contributors who participated in this project.

Acknowledgments

A shout out to anyone who's code was used in or provided inspiration to this project:

Christoph Herr, Gary Jones, Craig Simpson, Tim Jensen, Bill Erickson, Sridhar Katakam, Chinmoy Paul, Nathan Rice, Brian Gardner

Releases

No releases published

Packages

No packages published

Languages