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:

<?php foreach ($entries as $entry) : ?>
    <div class="entry">
        <h3>
            <?php echo $entry['title'] ?>
        </h3>

        <div class="post-content">
            <?php echo $entry['content'] ?>
        </div>
    </div>
<?php endforeach; ?>

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.