Download the PHP package picas/wp-template-hierarchy-everywhere without Composer
On this page you can find all versions of the php package picas/wp-template-hierarchy-everywhere. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download picas/wp-template-hierarchy-everywhere
More information about picas/wp-template-hierarchy-everywhere
Files in picas/wp-template-hierarchy-everywhere
Package wp-template-hierarchy-everywhere
Short Description A WordPress plugin that implements the 'template hierarchy' concept for any template
License GPL-3.0+
Homepage https://github.com/e-picas/wp-template-hierarchy-everywhere
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package wp-template-hierarchy-everywhere
The WordPress Template Hierarchy Everywhere
This plugin is an implementation of the "template hierarchy" concept of WordPress for any template.
It redefines some internal methods often used in templates to use the "template hierarchy" concept everywhere: for header, footer, sidebar, search form, sub-templates and assets.
Usage
Some new concepts & methods
The plugin first introduces a new concept: the ability to include a template passing it some arguments.
This concept is just an enhancement of the get_template_part($slug, $name = null)
internal function, with a third argument as an array of variables which will be loaded in the template:
get_template_part_fetch($slug, $name = null, $args = array())Actually, the arguments are extracted in the current environment using the native extract() PHP function.
The plugin also defines a function to get an asset URI (a CSS or JS file for instance), searching it first in
an optional child theme (if it exists) and falling back to the parent theme. This allows theme developers to
let the final user overwrite one of the theme assets without modifying the original file (please note that this
is not the same as overwritting a CSS rule in the child theme's style.css file as the original file of the
parent theme will not be loaded in our case).
This new function is:
get_asset_uri($name)The template hierarchy in action
The smart stuff of the plugin is to introduce a new get_template_part_hierarchical() function on the same model
as the classic get_template_part() with an implementation of the template hierarchy concept:
get_template_part_hierarchical($slug, $name = null, $include = true)This function will search a template file following the same rules as for "root templates" (natively concerned by the template hierarchy) and finally fallback to the default WordPress behavior.
As for the enhanced version of including a template fetching it arguments described above, an enhanced version of this new function also exists:
get_template_part_hierarchical_fetch($slug, $name = null, $include = true, $args = array())The template hierarchy aliases
As the core of WordPress does not allow to use its hooks to do so, you will have to use some new methods in replacement of common ones:
| original function | new function |
|---|---|
| get_template_part() | get_template_part_hierarchical() |
| get_footer() | get_footer_hierarchical() |
| get_header() | get_header_hierarchical() |
| get_sidebar() | get_sidebar_hierarchical() |
| comments_template() | comments_template_hierarchical() |
| get_search_form() | get_search_form_hierarchical() |
Have a look at the manual for a development of some of these features.
Installation
- Upload the plugin files to the
/wp-content/plugins/wp-template-hierarchy-everywheredirectory, or install the plugin through the WordPress plugins screen directly. - Activate the plugin through the 'Plugins' screen in WordPress
- You're done
You can also embed a standalone version of this library in a plugin or a theme (internal tests will avoid multi-loading).
Please see the releases of the repository to get last version (the master branch can have few commits forward but
the last release is the best choice).
NOTE - For those who are Composer users, the package is registered
as picas/wp-template-hierarchy-everywhere.
Note for developers
As you will see, I do NOT follow the WordPress coding rules but the PSR (http://www.php-fig.org/). The WordPress rules just sucks. Period.
Support
If you find a bug, please use the support panel of the repository. You may first search in existing issues to check if the bug you figured has not been reported yet.
License
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.
This plugin is made "avec amour" from Paris, France.
WP_Template_Hierarchy_Everywhere
Copyright (c) 2016, Pierre Cassat