Tea Page Content

Tea Page Content is a powerful plugin that allows create widget or shortcode with content of any page, post, etc, and customize look of blocks via template system. You can select one or more entries, choose template (or create your own) and display it by widget or shortcode. Templates presents very flexible system for appearance control.

Key features

• Very flexible template system
• Native support of all post types
• Possibility to create your own templates
• Developer and user friendly
• Easy to use and beautiful UI

If you found a bug or have a suggestion, please create topic on forum or send me email (raymondcostner at gmail.com).

Documentation

You can find primary description at Other Notes tab, and details at Github Page.

Documentation

Shortcodes

There is just one shortcode tea_page_content. Below there is an example with basic parameters.
[tea_page_content template=”default” order=”asc” posts=”12,45,23″]
You also can used template variables (see Templates section at documentation) and options.

Parameters

There is some built-in options. Let’s take a closer look:

• order allows you set entries order. All posts and pages will be sorted by date, and you can choose a direction – by ascending or by descending. Sorting by descending is a default behaviour.
• template allows you choose layout which will look as you want. In shortcode just type full name of your template without extension, for example default or your-template-name.
• show_page_thumbnail allows you enable or disable displaying thumbnail of entry. If you don’t want see page thumbnail, type show_page_thumbnail="false". Default – true.
• show_page_content allows you enable or disable displaying content of entry. Default – true.
• show_page_title allows you enable or disable displaying title of entry. Default – true.
• linked_page_title allows you enable or disable linking title of entry. In other words, title will be link to full article. Default – false.
• linked_page_thumbnail allows you enable or disable linking thumbnail of entry. In other words, thumbnail will be link to full article. Default – false.

Creating simplest custom template

By default plugin will be search custom templates in a folder named templates in your theme. For create the one just add into this directory a new file with name like tpc-{template-name}.php. Every template should be named by that mask! Then put in created file your code. For example:

For using your templates in shortcode, you need just choose it in widget or pass full filename (but without extension) in shortcode. For example:
template=”tpc-my-template”

Parameters in template

Above you can see very simple example of custom template with title and content parameters. But this is not all – there is a full list of allowed parameters which you can use.

• $count – Count of all passed entries
• $instance – Array with user defined and default parameters. There is all list of options from self-titled section above.
• $template_variables – Array with template-level variables.
• $caller – Special flag that determine a module that called template: from widget or from shortcode. Can be widget or shortcode.
• $entries – List of posts, pages, etc.
  • title – Title of current entry
  • content – Content of current entry. When page have more tag, will be used the_content function, in other cases will be used the_excerpt
  • thumbnail – Thumbnail of entry (if exists)
  • link – Link of entry
  • id – Entry ID

Details & Filters

Because full manual is too long, you can see it at Github Page. Get details and updating information about new features includes filters, template-level variables and more.

1. Upload the plugin archive to the /wp-content/plugins directory and unpack it, or install the plugin through the WordPress plugins screen directly
2. Activate the plugin through the ‘Plugins’ screen in WordPress

Installation Instructions

1. Upload the plugin archive to the /wp-content/plugins directory and unpack it, or install the plugin through the WordPress plugins screen directly
2. Activate the plugin through the ‘Plugins’ screen in WordPress

Is it just another page content plugin?

Yes, and no. This plugin lies between two edges – small plugins for little specific tasks and big frameworks.

Is this plugin compatible with custom post types?

Yes, it is.

Is this plugin compatible with my theme?

Yes. But every theme have unique css, and appearance of widget \ shortcode will be depend on theme styles.

I don’t have link to full post. How I can add it?

Links to full entry appears automatically – this feature depends of theme settings and WordPress core. If you have more-tag in post content, or if content length long enough, “read more” link will be available. We don’t override this behavior. Use native wordpress hooks for change it.

I found a bug or have a suggestion. What I can do?

You can create new topic in forum at wordpress.org, or send me email. I will answer you as soon as possible.

1. 

   Widget UI. Click by gear for open page level variables modal

2. 

   Page level variables window (opens after clicking by gear)

3. 

   Insert shortcode modal window

1.3.0

• ! Bump minimal required PHP version to PHP 5.6
• + Now you can select sortby natively
• + Added native validation of entries count. No more checks in templates!
• + In Bootstrap templates added possibility to choose base breakpoint
• - Removed support of all deprecated features (default-padded template, id shortcode param, thumbnail param)
• * Full compatibility with PHP7
• * Improved performance
• * Fix bug with “dead” filter tpc_config_array
• * Fix bug with incorrect handling names of template-level variables in some cases
• * Global code refactoring. Clean and shiny!

1.2.3

• + New template “Waterfall” added
• + New template “Bootstrap 4” added
• * Checked for WordPress 4.7 support

1.2.2

• + Added child themes support
• + Added possibility to change thumbnail size via filter tpc_thumbnail_size
• + Added settings page
• * Added popup notices for long titles in UI
• * Private, protected or draft entries not showing anymore in lists of entries
• * Fix bug with incorrect shortcode generate
• * Fix bug with incorrect page-level variables handling

1.2.1

• * Fix bug with non-opening modal window of page level variables

1.2.0

• + New feature – page-level variables
• + Added button for inserting shortcode in editor
• + New availaibe property in templates – caller. Value of caller maybe widget or shortcode if template in this moment using in shortcode or widget resp.
• + Enclosed shortcodes availaible
• * User Interface was improved for more usability
• * Checked for WordPress 4.6 support

1.1.1

• + Added new template-variable type “caption” that allows you describe your template
• * Checked for WordPress 4.5 support
• * Improved Bootstrap template

1.1.0

• + Native support for all existed post types (and custom too)
• + Count of entries now passed in template
• + New feature – template-level variables
• + New template: Bootstrap 3.x
• + Added possibility hide title, content and link it. This feature depends of used template (all built-in templates except deprecated supports it)
• - Default-Padded template, thumbnail widget and shortcode parameter, id shortcode parameter is deprecated
• * CSS for frontend part changed, improved paddings, added some hover effects
• * Global code refactoring. We are friendly for developers!
• * Bug fixes

1.0.0

• First release with basic functionality