Michel - xiligroup dev

<h4>on monolingual website (blog or CMS)</h4>
<p>xili-tidy-tags is a tool for grouping tags by semantic groups and sub-groups.<br />
This tags aggregator can also, by instance, be used to group tags according two or more main parts of the CMS website. It is also possible to create group of tags in parallel of category and display a ‘sub’ tag cloud only depending of the displayed category.</p>
<h4>on multilingual website</h4>
<p>xili-tidy-tags is a tool for grouping tags by language with xili-language plugin for multilingual site and for creating tidy tag clouds. By instance to present only tags in english when the theme is in english because the post or the current category present texts in english. Technically, as xili-language, this plugin don’t create tables in wordpress db. He only use (rich) taxonomy features. So, with or without the plugin, the base structure is not modified.</p>
<h4>Why xili-tidy-tags versus / against included parent property of terms ?</h4>
<p>With default parent feature, a tag (term) can have only one parent. The default taxonomy (see file taxonomy.php in folder wp-includes) is very poweful but don’t include the queries to group tags under one another tag. Is is the purpose of this plugin xili-tidy-tags created since WP 2.7 ! Initially created to group tags by language, he structurally contains all functions to group tags by semantic groups AND one tag can belong to one or more groups.</p>
<h4>Why xili-tidy-tags introduces grouping features since version 1.9 ?</h4>
<p><strong>RESERVED for DEVELOPERS using template-tags</strong><br />
Using nice feature “alias of” and “group” of WP core taxonomy.php, xili-tidy-tags offers now a way to “link” tags of different languages (red, rouge, rot,…). So when displaying list of french posts associated with a french tag (<em>rouge</em>), it is now possible to show a list of tags in other languages (<em>red, rouge, rot,…</em>) and visitor is now able to click on <em>red</em> and show the webpage of list of posts tagged with <em>red</em>. Only taxonomy wpdb tables are used, no new tables, no new lines in options table.</p>
<h4>Widget to insert Tags cloud</h4>
<p>The powerful widget is easy to setup and to choose what and when group of tags to display.</p>
<h4>Template tags usable in theme design</h4>
<p>Template tags are provided to enrich the theme and display sub-selection of tags.<br />
Through the settings admin UI, it is possible to assign to a tag one or more groups (by instance a french tag to the french language group. A trademark term like WordPress to a group named “trademark”. You can choose different storage policies.</p>
<p><strong>NEW 2 template-tags since 1.9 :</strong> <code>xili_tidy_tags_group_links</code> to show the group of tags containing the current tag (useful in tag.php of theme) and <code>xili_tidy_tag_in_other_lang</code> to return info (link) of one other tag of the group in an another lang. Xili-language version > 2.9.0 will use the links switching in language switching navigation menu when displaying tag.php page. (if “red” tag page is displayed, language menu for french will link to “rouge” !)</p>
<h4>Shortcode</h4>
<p>add shortcode inside a post content to include in your text a cloud of a group of tags.</p>
<p><strong>Example of shortcode :</strong>  <code>[xili-tidy-tags params="tagsgroup=trademark&largest=10&smallest=10" glue=" | "]</code><br />
In this cas, the group of tags named ‘trademark’ will be display inside a paragraph of a post. The params are defined as in <code>xili_tidy_tag_cloud()</code> and as in <code>wp_tag_cloud()</code>. The glue is chars inserted between the tags (if omitted default is a space).</p>
<p><a href="http://dev.xiligroup.com/?xilifunctions=shortcode-xili-tidy-tags" rel="nofollow ugc">Example of tag cloud made with shortcode here</a></p>
<h4>TRILOGY FOR MULTILINGUAL CMS SITE</h4>
<p>Please verify that you have installed the latest versions of:<br />
<a href="https://wordpress.org/extend/plugins/xili-language/" rel="ugc">xili-language</a>, <a href="https://wordpress.org/extend/plugins/xili-tidy-tags/" rel="ugc">xili-tidy-tags</a>, <a href="https://wordpress.org/extend/plugins/xili-dictionary/" rel="ugc">xili-dictionary</a></p>
<h4>Translations available for admin UI</h4>
<ul>
<li>english, french by the author,</li>
<li>spanish and serbian – contributions of <a href="http://www.firstsiteguide.com" rel="nofollow ugc">Ognjen D., firstsiteguide.com</a></li>
</ul>
<h4>Roadmap</h4>
<ul>
<li>readme.txt rewritting.</li>
<li>more function for grouping new features introducted in version 1.9</li>
</ul>
<h4>Version 1.12.06</h4>
<ul>
<li>fixes forget sanitize – thanks to vgo0 (report by WordFence)</li>
<li>Last Updated 2024-11-04</li>
</ul>
<h4>Version 1.12.04</h4>
<ul>
<li>fixes forget nounce</li>
<li>Last Updated 2023-08-01</li>
</ul>
<h4>Version 1.12.01</h4>
<ul>
<li>Last Updated 2019-05-18</li>
<li>rewritten with WPCS rules</li>
<li>prerequisite PHP 7.1+</li>
<li>Previous Tags: tag,tags,theme,post,plugin,posts, page, category, admin,multilingual,taxonomy,dictionary,widget,CMS, multisite, wpmu, bbPress, shortcode</li>
<li>see <a href="https://wordpress.org/extend/plugins/xili-tidy-tags/changelog/" rel="ugc">tab and chapters in changelog</a></li>
</ul>
<h3>More infos</h3>
<h4>Capabilities and roles :</h4>
<p>0.9.5 : Administrator role can create grouping or setting capabilities for editor role. ‘Grouping’ permits to editor to group tags in group (lang and/or semantic). ‘Setting’ permits to editor to create, modify or delete semantic groups. Only administrator has access to languages groups.</p>
<p>The plugin post is frequently documented <a href="http://dev.xiligroup.com/" rel="nofollow ugc">dev.xiligroup.com</a><br />
and updated <a href="https://wordpress.org/extend/plugins/xili-tidy-tags/download/" rel="ugc">WordPress repository</a>.</p>
<p>See also the <a href="http://dev.xiligroup.com/?forum=xili-tidy-tags-plugin" rel="nofollow ugc">dev.xiligroup plugins forum</a>.</p>
<p>© 2009-2020 MS – dev.xiligroup.com</p>


xili-tidy-tags

xili-tidy-tags is a tool for grouping tags by semantic groups or by language and for creating tidy tag clouds.

Marcin Kazmierski

<h4>What is “Theme and plugin translation for Polylang”?</h4>
<p>Extension for Polylang plugin (Polylang is an extension to make multilingual WordPress websites.).<br />
Plugin is needed to translate the WordPress themes and plugins by Polylang.</p>
<h4>How to configure it?</h4>
<p>Select themes and plugins to find texts for translation by Polylang.<br />
In admin dashboard:</p>
<pre><code>Languages -> TTfP Settings
</code></pre>
<h4>How it is work?</h4>
<p>“Theme and plugin translation for Polylang” automatically searches all files of WordPress themes and plugins. It chooses from this file only those files with extensions:</p>
<ul>
<li>php</li>
<li>inc</li>
<li>twig</li>
</ul>
<p>In addition, is implemented the integration with Timber library (read more: http://timber.upstatement.com) – which allows to translate twig’s skins in simple way.<br />
Plugin in searched skins or plugins chooses texts from Polylang functions, such as:</p>
<ul>
<li>_e(string $text, string $domain = ‘default’);</li>
<li>__(string $text, string $domain = ‘default’);</li>
<li>_x(string $text, string $context, string $domain = ‘default’);</li>
<li>pll_e(string $text);</li>
<li>pll__(string $text);</li>
<li>esc_html(string $text);</li>
<li>esc_html_e(string $text, string $domain = ‘default’);</li>
<li>esc_html__(string $text, string $domain = ‘default’);</li>
<li>_n(string $single, string $plural, int $number, string $domain = ‘default’);</li>
<li>esc_attr_e(string $text, string $domain = ‘default’);</li>
<li>esc_attr__(string $text, string $domain = ‘default’);</li>
</ul>
<p>In your function.php, themes or plugins.</p>
<p>For example:</p>
<pre><code><p><?php pll_e('My text'); ?></p>

<p><?php _e('My another text', 'my_theme'); ?></p>
</code></pre>
<p>On the timber context declare this functions like:</p>
<pre><code>$context['pll_e'] = TimberHelper::function_wrapper('pll_e');

$context['pll_'] = TimberHelper::function_wrapper('pll_');
</code></pre>
<p>See more on: <code>https://polylang.wordpress.com/documentation/documentation-for-developers/functions-reference/</code><br />
These functions are defined by Polylang plugin for printing translations.<br />
Thanks “Theme and plugin translation for Polylang” you can find these strings to translate and add to Polylang register on very simple way.<br />
And then you can translate these texts from the admin dashboard.<br />
The scan result can be seen on the tab with translations:</p>
<pre><code>Settings -> Languages -> String translation
</code></pre>
<p>or</p>
<pre><code>Languages -> String translation
</code></pre>
<p>You don’t need programs like poedit – you don’t change files with extensions like: <code>.pot</code>, <code>.po</code>, <code>.mo</code>.<br />
“Theme and plugin translation for Polylang” is highly efficient because the scanner is worked only on admin dashboard in tab:<br />
In dashboard:</p>
<pre><code>Settings -> Languages -> String translation
</code></pre>
<p>or</p>
<pre><code>Languages -> String translation
</code></pre>
<h4>Export and import string translation</h4>
<p>In dashboard:</p>
<pre><code>Languages -> TTfP Settings
</code></pre>
<h4>Filter reference</h4>
<pre><code>ttfp_domains
</code></pre>
<p>Allows plugins and themes (in functions.php) to modify list of text domains (unique identifier for retrieving translated strings).<br />
List of text domains is displayed on “TTfP Settings” page to select them for translation by polylang engine.</p>
<p>Example:</p>
<pre><code>add_filter('ttfp_domains', 'custom_ttfp_domains', 10, 1);
function custom_ttfp_domains(array $domains):array
 {
     $domains[] = "my-custom-domain";
     return $domains;
 }
</code></pre>
<h4>Filter reference</h4>
<pre><code>ttfp_translation_access
</code></pre>
<p>Returns whether the user has capability to view and edit translations provided by TTfP.</p>
<p>Example:</p>
<pre><code>add_filter('ttfp_translation_access', 'custom_ttfp_translation_access', 10, 1);
function custom_ttfp_translation_access(bool $hasAccess):bool
 {
     return current_user_can('edit_posts');
 }
</code></pre>


Theme and plugin translation for Polylang (TTfP)


Great plugin and DEV, nothing more to say.


Great plugin and DEV


Works perfectly and very simple to use!


Works perfectly!

Theme and plugin translation using Polylang for WordPress. Extension for Polylang plugin.

xili-tidy-tags vs Theme and plugin translation for Polylang (TTfP)