Popis
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).
Dokumentace
You can find primary description at Other Notes tab, and details at Github Page.
Dokumentace
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.
Nastavení
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
oryour-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
orshortcode
. - $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 usedthe_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.
Snímky obrazovky
Instalace
- Upload the plugin archive to the
/wp-content/plugins
directory and unpack it, or install the plugin through the WordPress plugins screen directly - Activate the plugin through the ‚Plugins‘ screen in WordPress
Nejčastější dotazy
- Installation Instructions
-
- Upload the plugin archive to the
/wp-content/plugins
directory and unpack it, or install the plugin through the WordPress plugins screen directly - Activate the plugin through the ‚Plugins‘ screen in WordPress
- Upload the plugin archive to the
- 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.
Recenze
Pro tento plugin nejsou žádné recenze.
Autoři
Tea Page Content je otevřený software. Následující lidé přispěli k vývoji tohoto pluginu.
SpolupracovníciPřeložte “Tea Page Content” do svého jazyka.
Zajímá vás vývoj?
Prohledejte kód, podívejte se do SVN repozitáře, nebo se přihlaste k odběru protokolu vývoje pomocí RSS.
Přehled změn
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 maybewidget
orshortcode
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