Title: Tea Page Content
Author: Raymond
Published: December 31, 2015
Last modified: November 17, 2017
---
Search plugins
This plugin **hasn’t been tested with the latest 3 major releases of WordPress**.
It may no longer be maintained or supported and may have compatibility issues when
used with more recent versions of WordPress.
# Tea Page Content
By [Raymond](https://profiles.wordpress.org/tsjuder/)
[Download](https://downloads.wordpress.org/plugin/tea-page-content.1.3.1.zip)
* [Details](https://test.wordpress.org/plugins/tea-page-content/#description)
* [Reviews](https://test.wordpress.org/plugins/tea-page-content/#reviews)
* [Installation](https://test.wordpress.org/plugins/tea-page-content/#installation)
* [Development](https://test.wordpress.org/plugins/tea-page-content/#developers)
[Support](https://wordpress.org/support/plugin/tea-page-content/)
## Description
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](https://wordpress.org/plugins/tea-page-content/other_notes/)
tab, and details at [Github Page](http://tsjuder.github.io/tea-page-content/).
### 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](http://tsjuder.github.io/tea-page-content/).
Get details and updating information about new features includes filters, template-
level variables and more.
## Screenshots
* [[
* Widget UI. Click by gear for open page level variables modal
* [[
* Page level variables window (opens after clicking by gear)
* [[
* Insert shortcode modal window
## Installation
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
## FAQ
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.
## Reviews
There are no reviews for this plugin.
## Contributors & Developers
“Tea Page Content” is open source software. The following people have contributed
to this plugin.
Contributors
* [ Raymond ](https://profiles.wordpress.org/tsjuder/)
[Translate “Tea Page Content” into your language.](https://translate.wordpress.org/projects/wp-plugins/tea-page-content)
### Interested in development?
[Browse the code](https://plugins.trac.wordpress.org/browser/tea-page-content/),
check out the [SVN repository](https://plugins.svn.wordpress.org/tea-page-content/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/tea-page-content/)
by [RSS](https://plugins.trac.wordpress.org/log/tea-page-content/?limit=100&mode=stop_on_copy&format=rss).
## Changelog
#### 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
## Meta
* Version **1.3.1**
* Last updated **8 years ago**
* Active installations **10+**
* Tested up to **4.9.29**
* Language
* [English (US)](https://wordpress.org/plugins/tea-page-content/)
* Tags
* [pages](https://test.wordpress.org/plugins/tags/pages/)[post](https://test.wordpress.org/plugins/tags/post/)
[posts](https://test.wordpress.org/plugins/tags/posts/)[shortcode](https://test.wordpress.org/plugins/tags/shortcode/)
[widget](https://test.wordpress.org/plugins/tags/widget/)
* [Advanced View](https://test.wordpress.org/plugins/tea-page-content/advanced/)
## Ratings
No reviews have been submitted yet.
[Your review](https://wordpress.org/support/plugin/tea-page-content/reviews/#new-post)
[See all reviews](https://wordpress.org/support/plugin/tea-page-content/reviews/)
## Contributors
* [ Raymond ](https://profiles.wordpress.org/tsjuder/)
## Support
Got something to say? Need help?
[View support forum](https://wordpress.org/support/plugin/tea-page-content/)