=== Enhanced Category Pages === Contributors: cip, dioneea, danaila_iulian Tags: categories, taxonomy, term, page, enhanced, custom post, custom post type, category, featured image Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=7K3XA4WQ2BUVJ&lc=US&item_name=Enhanced%20Category%20Wordpress%20Plugin&item_number=Support%20Open%20Source¤cy_code=USD&bn=PP%2dDonationsBF%3abtn_donateCC_LG%2egif%3aNonHosted Requires at least: 3.0.1 Tested up to: 4.5.3 Stable tag: 2.3.0 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html Create custom enhanced pages for categories and any taxonomy term and manage them as a custom post. == Description == **NEW** Version 2.0.0 brings a great new feature: with some magic, if your theme displays category/term description, then it would be **automatically** enhanced. Are you ready for more? You can customize the template by creating a `content-ecp.php` file in your theme of choice. Enhanced Category Pages allows you to create custom category and term pages by managing them using a special custom post type. **Premium code quality** ensured by Codacy static analysis: [grade A](https://www.codacy.com/app/2wit/enhanced-category-pages). **Features** * **NEW** Visual Composer compatible - you can now edit the category using Visual Composer * **NEW** Genesis Framework compatible * WooCommerce compatible - product categories can be enhanced now * Easy to use for everyone: users, designers, developers * Automatically show enhanced category/term content * Customize enhanced category/term content by creating a `content-ecp.php` file in your theme of choice * Traverse categories using setup_ec_data that allows now category id as parameter * Enhance any taxonomy: edit **any taxonomy** term as a custom post * Edit category as a custom post - *Enhanced Category* * Automatically generates *Enhanced Category* post type for each category * Transparent synchronization of *Enhanced Category* and it's corresponding category * Add any features available to WordPress custom posts * Easy *Enhanced Category* display on category template using `<?php $GLOBALS['enhanced_category']->setup_ec_data(); ?>` (see install section) * Internationalization ready **Future Features** * customize *Enhanced Category* custom post type capabilities via plugin options * manual selection on enhanced categories == Installation == 1. Download plugin archive. 2. Upload and uncompress it in "/wp-content/plugins/" directory. 3. Activate the plugin through the "Plugins" menu in WordPress. 4. Use "Enhanced Edit" link to edit the page of the respective category 5. Category/term description display is automatically enhanced with your content. 6. Optional: create `content-ecp.php` in your theme folder to customize the display. **Advanced usage options** 1. Create `content-ecp.php` in your theme folder to customize the display of the enhanced content. The custom post associated with category/term is set up, so all display functions for posts are usable. <?php global $enhanced_category; // if not previously set up, then let setup_ec_data get the current query term/category if (empty($categoryId)) { $categoryId = null; } // get enhanced category post and set it up as global current post $enhanced_category->setup_ec_data($categoryId); ?> <!-- enchanced category page (ECP) content --> <article id="post-<?php the_ID(); ?>" <?php post_class(); ?>> <div class="post-thumbnail"> <?php the_post_thumbnail(); ?> </div> <div class="entry-content"> <?php the_content(); ?> </div><!-- .entry-content --> <?php edit_post_link( __( 'Edit'), '<footer class="entry-footer"><span class="edit-link">', '</span></footer><!-- .entry-footer -->' ); ?> </article><!-- #post-## --> 1. Display category/term page. Edit **category/taxonomy template** to show the content of the "Enhanced Category" (feel free to adjust to your needs): //in category.php or taxonomy.php or any other place your theme displays the category/term content <?php global $enhanced_category; //get enhanced category post and set it up as global current post $enhanced_category->setup_ec_data(); ?> <!-- enhanced category content --> <?php the_post_thumbnail("medium"); ?> <?php get_template_part( 'content', 'page' ); ?> <!-- custom fields --> <?php get_post_custom(); ?> <?php // If comments are open or we have at least one comment, load up the comment template if ( comments_open() || get_comments_number() ) : comments_template(); endif; ?> 1. Display a list of categories: //$categories is presumed to be an already fetched array of categories/terms foreach($categories as $category) { $GLOBALS['enhanced_category']->setup_ec_data($category->term_id); the_post_thumbnail('thumbnail'); } == Frequently Asked Questions == = How does magic happen? = We use the `category_description` or `get_the_archive_description` filters in order to replace the plain content with the enhanced one. = How can I customize the output? = * `content-ecp.php` and `content-page.php` partial templates are looked for (in that order) and the first found is loaded. = What custom post type is created? = *Enhanced Category* (safe name: enhancedcategory) custom post type is created and a post is generated automatically for each category/term. = What happens if I edit the category fields? = *Enhanced Category* Post (ECP) is synchronized in both directions with it's corresponding category i.e. category name - ECP title, category slug - ECP slug, category description - ECP excerpt. = What happens with *Enhanced Category* posts when the plugin is uninstalled? = *Enhanced Category* posts are deleted when the plugin is deleted using the WordPress plugin management page. Note: nothing is deleted when the plugin deactivated. = Can I use it to list any categories/terms? = Yes, you can pass the category/term id to `setup_ec_data` method like this (`$categories` is presumed to be an already fetched array of categories/terms): ` foreach($categories as $category) { $GLOBALS['enhanced_category']->setup_ec_data($category->term_id); the_post_thumbnail('thumbnail'); } ` = Why do I get a blank screen after installing the plugin? = *Enhanced Category Post* (ECP) requires at least PHP 5.3 running on your server. Contact your hosting to update the PHP version. == Screenshots == 1. Enhanced Edit link in category list 2. Enhanced Edit link in category edit 3. Enhanced Category custom post type edit 4. Category public view == Changelog == = 0.1 = * Initial release. = 0.2 = * Make php 5.3 compatible. = 1.0 = * Enhance any taxonomy = 1.0.1 = * bug fixing = 1.0.2 = * setup_ec_data allows now category id as parameter = 2.0.0 = * automatically show the enhanced content using `category_description` or `get_the_archive_description` filters * customize the display of content with `content-ecp.php` theme partial template = 2.0.1 = * bug-fix - prevent undesired PHP warning on category_description filter * check and update 4.3.1 compatibility = 2.1.0 = * WooCommerce product category can be enhanced now = 2.1.1 = * Improve code quality = 2.1.2 = * Add WordPress 4.4 compatibility = 2.1.3 = * Bug fix: correctly handle categories with apostrophes = 2.2.0 = * All in One SEO Pack plugin compatibility added = 2.2.1 = * Minor bug fix: prevent PHP notice = 2.3.0 = * Add Visual Composer compatibility * Add Genesis Framework compatibility * Bug fix: Woocommerce shop page does not display the description of the first product anymore * Bug fix: archive pages were showing the content of the first item == Upgrade Notice == = 0.2 = * This version adds support for 5.3 = 1.0 = * Enhance a term from any taxonomy = 1.0.1 = * Bugs fixed = 1.0.2 = * traverse categories using setup_ec_data that allows now category id as parameter = 2.0.0 = * This version adds magic: automatically show the enhanced content using `category_description` or `get_the_archive_description` filters. = 2.0.1 = * Bug fixing: prevent undesired PHP warning on category_description filter and update compatibility up to WordPress 4.3.1 = 2.1.0 = * New feature: WooCommerce product category can be enhanced now = 2.1.1 = * Improve code quality = 2.1.2 = * Add WordPress 4.4 compatibility = 2.1.3 = * Bug fix: correctly handle categories with apostrophes = 2.2.0 = * All in One SEO Pack plugin compatibility added = 2.2.1 = * Minor bug fix: prevent PHP notice = 2.3.0 = * Add Visual Composer compatibility * Add Genesis Framework compatibility * Bug fix: Woocommerce shop page does not display the description of the first product anymore * Bug fix: archive pages were showing the content of the first item
acip/enhanced-category-pages
Wordpress plugin - create custom enhanced pages for categories and any taxonomy term and manage them as a custom post.
PHP