Eddie Moya

<p>Adds several new templates to the template hierarchy:</p>
<ul>
<li>child-of-category-{slug}.php</li>
<li>category-{slug}.php</li>
<li>child-of-category-{id}.php</li>
<li>category-{term_id}.php</li>
<li>parent-category.php</li>
<li>child-category.php</li>
<li>category.php</li>
<li>archive.php</li>
<li>index.php</li>
</ul>
<p>This greatly extends the native hierarchy of theme templates with regard to<br />
categories. Theme developers can now easily create separate templates for<br />
categories with children, with parents, and children of specific parents.</p>
<p>Additionally makes available four (4) new conditional template tags:</p>
<ul>
<li>is_child_category();</li>
<li>is_parent_category();</li>
<li>is_child_of_category();</li>
<li>is_parent_of_category();</li>
</ul>
<p>These functions are available for use in any theme or plugin as along as this<br />
plugin is active. For detailed documentation of these functions see the<br />
‘Developer Notes: Conditional Tags’ section of this readme file.</p>
<p>Note: This plugin does not actually create parent-category.php, child-category.php<br />
or any of their related templates – rather it modifies the native <a href="https://codex.wordpress.org/Template_Hierarchy" rel="nofollow ugc">template hierarchy</a><br />
to allow theme developers to create specific templates for parent and child categories.</p>
<h3>Developer Notes: Template Hierarchy</h3>
<p>What follows are is the modified list of templates available for category pages.<br />
These expand upon the native <a href="https://codex.wordpress.org/Template_Hierarchy#Visual_Overview" rel="nofollow ugc">Template Hierarchy</a>.</p>
<ul>
<li>child-of-category-{slug}.php</li>
<li>category-{slug}.php</li>
<li>child-of-category-{id}.php</li>
<li>category-{term_id}.php</li>
<li>parent-category.php</li>
<li>child-category.php</li>
<li>category.php</li>
<li>archive.php</li>
<li>index.php</li>
</ul>
<p>The parent and child templates only become available if the current category is<br />
a parent or a child respectively.</p>
<p>Note: This plugin does not actually create parent-category.php, child-category.php<br />
or any of their related templates – rather it modifies the native <a href="https://codex.wordpress.org/Template_Hierarchy" rel="nofollow ugc">template hierarchy</a><br />
to allow theme developers to create specific templates for parent and child categories.</p>
<h3>Developer Notes: Conditional Tags</h3>
<p>With this plugin comes two additional <a href="https://codex.wordpress.org/Conditional_Tags" rel="nofollow ugc">conditional tags</a><br />
which behave much like any other in WordPress. In a similar fashion to how one<br />
might use <a href="https://codex.wordpress.org/Function_Reference/is_category" rel="nofollow ugc">is_category()</a> or <a href="https://codex.wordpress.org/Function_Reference/cat_is_ancestor_of" rel="nofollow ugc">cat_is_ancestory_of()</a>,<br />
developers may, with this plugin, use the following functions:</p>
<ul>
<li>is_parent_category()</li>
<li>is_child_category()</li>
<li>is_child_of_category()</li>
<li>is_parent_of_category()</li>
</ul>
<h4>Description (part 1)</h4>
<p>The <code>is_parent_category()</code> and <code>is_child_category()</code> conditional tags check if<br />
the page being displayed (or passed as an argument) is of a category that has<br />
children (e.g. is a parent category)  has a parent (is a child), respectively.<br />
They are boolean functions, meaning they return either TRUE or FALSE.</p>
<h4>Usage</h4>
<pre><code><?php is_parent_category( $category ); ?>
<?php is_child_category( $category ); ?>
</code></pre>
<h4>Parameters</h4>
<p>$category (integer/string/object) (optional) Category ID, Category Slug, Category Object. Default: Current Category</p>
<p>Note: Unlike is_category(), these functions will not take arrays of categories or category titles. I’ll work on that. Sorry.</p>
<h4>Return Values</h4>
<p>(boolean) True on success, false on failure.</p>
<h4>Examples</h4>
<pre><code>is_parent_category()
is_child_category()
// When any parent/child category archive page is being displayed

is_parent_category( '9' );
is_child_category( '9' );
// When the archive page for Category 9 is being displayed AND its a parent/child.

is_parent_category( 'blue-cheese' );
is_child_category( 'blue-cheese' );
// When the archive page for the Category with Category Slug "blue-cheese" is being displayed AND its a parent/child.
</code></pre>
<h4>Description (part 2)</h4>
<p>The <code>is_parent_of_category()</code> and <code>is_child_of_category()</code> conditional tags<br />
check if a given category has a parent or child relationship to the current<br />
category or a category passed as its second parameter. They are<br />
boolean functions, meaning they return either TRUE or FALSE.</p>
<h4>Usage</h4>
<pre><code><?php is_parent_of_category($child_category, $parent_category, $direct_descendant); ?>
<?php is_child_of_category($parent_category, $child_category, $direct_descendant);?>
</code></pre>
<h4>Parameters</h4>
<p>(object/string/integer) (required) Category of the would-be parent/child respectively.<br />
(object/string/integer) (optional) Category of the would-be child/parent respectfully. Default: Current Category<br />
(boolean) (optional) Whether or not the child should be a direct child of the parent. Default: True<br />
 *</p>
<h4>Return Values</h4>
<p>(boolean) If the $direct_descendant flag set to true, function returns true if the child is a direct descendant of the parent, if child is no direct it will return false. If $direct_descendant is set to false it will return the same results as cat_is_ancestor_of().</p>
<h4>Examples</h4>
<p>The following function will return True…</p>
<pre><code>is_child_of_category(0);
// When a top level category is being displayed, zero being the parent id value for top level categories (e.g. categories with no parents).

is_child_of_category(12);
// When the current category is a direct child of the category whose ID is '12'.

is_child_of_category('tv-shows')
// When the current category is a direct child of the category with the slug 'tv-shows' (can also be category ID's).

is_child_of_category('tv-shows', 'dexter');
// When the category with slug 'dexter' is a direct child of the category with the slug 'tv-shows' (can also be category ID's). This may come in handy when manipulating categories while not in a category template.

is_child_of_category('tv-shows', 'dexter', false);
// When the category with the slug 'dexter' is a descendant of the category 'tv-shows' at any level. (uses cat_is_ancestor_of())

is_child_of_category('tv-shows', null, false);
// When the current category is a descendant of the 'tv-shows' category at any level. (uses cat_is_ancestor_of())

is_parent_of_category(13);
// When the current category is the direct parent of a category with the ID '13'.

is_parent_of_category('dexter');
// When the current category is the direct parent of the category with the slug 'dexter'.
</code></pre>
<h3>Backward Compatibility</h3>
<p>The changes this plugin makes to the template hierarchy are significantly different<br />
from that in 1.0.5 and before. If you prefer to use that version please find it<br />
in the Older Versions in the WordPress plugins directory, it is tagged as 1.0.5.</p>
<p>While I do not actively support to QA the older version, I would gladly take a<br />
look at any future bugs that crop up and are reported.</p>


Category Template Hierarchy

Adds parent-category.php, child-category.php, and child-category-{slug|id} templates to the hierarchy and conditional tags to match.

Neelkanth Kaushik

<p>WP My Favourites is a simple plugin which allows you to select the best posts, pages, comments and media from backend and fetch them as and when needed in your website. It also allows you to reorder your favourite as per your wish using Drag and Drop.</p>
<h3>Some of the features</h3>
<ul>
<li>AJAX-powered backend settings section.</li>
<li>Tabular UI for easy management.</li>
<li>Tooltips on hover and Help(?) icons in the backend for first time users.</li>
<li>Choose your best items simple by clicking the Thumbs Up/Thumbs Down icons.</li>
<li>Easily reorder by dragging and dropping the selected posts.</li>
<li>No need to click save button etc. Selected items are saved in database as the selects or reorder them.</li>
<li>Change the settings as per your need from the settings given in WP My Favourites – Configuration section in backend.</li>
</ul>
<h3>How to use – Backend</h3>
<ol>
<li>After activating the plugin you can see WP My Favourites menu item in the dashboard.</li>
<li>Under the menu name you can see two sub menus: Favourite posts, Favourite comments, Favourite media.</li>
<li>Click on any sub menu. Suppose you clicked on Favourite posts.<br />
(Note: Favourite posts also lets you select pages also.)</li>
<li>You can change the settings for the listing and selection of favourites by clicking on the Settings section.</li>
<li>On top you will see Select any 15 posts by default. This 15 can be changed in the <code>wp-myfavourites/wp-myfavourites.php</code> file.</li>
<li>Adjacent to Select any 15 posts in Help(?) icon. Hover it to get some help.</li>
<li>The first table shows all the posts and pages. You can also add custom posts be adding the custom post type slug in <code>const WP_MYFAVOURITES_POST_TYPE</code> array in <code>wp-myfavourites/wp-myfavourites.php</code> file.</li>
<li>To select a post simple click on the Black Thumbs Up which represents un-selected post. Once you click on the Black Thumbs Up that post will be added to the Favourite post section and the Black Thumbs Up will turn into Blue.</li>
<li>You can see your selected posts in the second table. To reorder the posts simple Drag the first cell in the second table and Drop on the desired position.</li>
<li>If you want to remove a selected post then simple Click on the Blue Thumbs Up on the first table or click on the Blue Thumbs Down in the second table.</li>
<li>The same applies to the Favourite comment and Favourite Media section as well.</li>
</ol>
<h3>How to use – Frontend</h3>
<h3>Getting listing using shortcodes</h3>
<h3>1. Get favourite posts with HTML</h3>
<pre><code>[show-favourite-posts post_types='post,page' no_of_posts=-1 no_of_chars='20']
</code></pre>
<p>Shorcode arguments:</p>
<ul>
<li>post_types: Comma separated list of post types to fetch from selected posts in backend.</li>
<li>no_of_posts: Number specifying the total number of posts to fetch from the selected posts.</li>
<li>no_of_chars: Number specifying the number of characters to get from the post’s content.</li>
</ul>
<h3>2. Get favourite comments with HTML</h3>
<pre><code>[show-favourite-comments no_of_comments=10 no_of_chars=20]
</code></pre>
<p>Shorcode arguments:</p>
<ul>
<li>no_of_comments: Number specifying the total number of comments to fetch from the selected comments.</li>
<li>no_of_chars: Number specifying the number of characters to get from the comment’s content.</li>
</ul>
<h3>3. Get favourite media with HTML</h3>
<pre><code>[show-favourite-media no_of_media=20 image_size=120,120]
</code></pre>
<p>Shorcode arguments:</p>
<ul>
<li>no_of_media: Number specifying the total number of media items to fetch from the selected media.</li>
<li>image_size: Comma separated width and height respectively of the image. Default is 20,20.</li>
</ul>
<h3>Getting WP_Post and WP_Comment Object</h3>
<h3>1. Get array favourite posts</h3>
<p>Call <code><?php Wp_MyFavourites_Public::wp_mf_favourite_posts($post_types,$number_of_posts ) ?></code></p>
<p>Method arguments:</p>
<ul>
<li>$post_types: Array of post types to fetch from the selected posts</li>
<li>$number_of_posts: Number specifying the total number of posts to fetch from the selected posts.</li>
</ul>
<h3>2. Get array of favourite comments</h3>
<p>Call <code><?php Wp_MyFavourites_Public::wp_mf_favourite_comments($no_of_comments) ?></code></p>
<p>Method arguments:</p>
<ul>
<li>$number_of_comments: Number specifying the total number of comments to fetch from the selected posts.</li>
</ul>
<h3>3. Get array of favourite media</h3>
<p>Call <code><?php Wp_MyFavourites_Public::wp_mf_favourite_media($no_of_media) ?></code></p>
<p>Method arguments:</p>
<ul>
<li>$no_of_media: Number specifying the total number of media items to fetch from the selected media.</li>
</ul>
<h3>3. Getting array of selected ids</h3>
<ol>
<li><code><?php Wp_MyFavourites_Public::wp_mf_get_favourite_ids($type,$count) ?></code></li>
</ol>
<p>Method arguments:</p>
<ul>
<li>$type: Accepts ‘posts’ or ‘comments’ or ‘media’ as parameters</li>
<li>$count: Number of ids to fetch</li>
</ul>


WP My Favourites

Choose your favourite posts, pages, comments, media and reorder them to display anywhere on your website.

Category Template Hierarchy vs WP My Favourites