radovank

<p>Template Dictionary is a plugin which can be used to create template variables editable by admins.</p>
<p>The plugin is multilingual ready. It includes Polylang integration, another multilingual plugin can be integrated with filters.</p>
<h4>Admin pages</h4>
<p>There are few admin pages for managing the plugin.</p>
<ul>
<li><strong>Template Dictionary</strong> – view, edit and delete the template variables values</li>
<li><strong>Settings list</strong> – view, edit and delete template variables settings</li>
<li><strong>Add setting</strong> – add new or edit template variables setting</li>
<li><strong>Edit values</strong> – edit a value, this page is accessable from the page <strong>Template Dictionary</strong></li>
<li><strong>Export/Import</strong> – export settings and values to xml or import it from xml</li>
</ul>
<h4>Usage in template</h4>
<p>You can use a value in template by calling function <code>get</code> of Template Dictionary object, which can be accessed by function <code>TmplDict()</code>.</p>
<p>For example, if you set a setting with code <em>the_code</em>, you can use it’s value by:</p>
<pre><code>TmplDict()->get( 'the_code' );
</code></pre>
<p>This function returns the value. If you need to echo the value, you can use function <code>eget</code>. Both functions have an optional argument <code>$default</code>, which is the default returned/echoed value, if the admin value is empty.</p>
<p>You can also get the value by accessing the code as property:</p>
<pre><code>$value = TmplDict()->the_code;
</code></pre>
<h4>Usage with shortcode</h4>
<p>You can also use a shortcode <code>[tmpl_dict]</code> with attributes <code>code</code>, <code>default</code> and <code>do_shortcode</code>. The last attribute says, if the function <code>do_shortcode</code> will be called on the value.</p>
<h4>Setup template language</h4>
<p>Default template language can be set by setting the constant <code>TMPL_DICT_DEFAULT_LANG</code> in wp-config. Default value of this constant consists of two first characters of the current WP locale. <strong>It is important to set the default language constant properly if you plan to create your site multilingual in future.</strong></p>
<p><strong>If you have a multilingual site</strong>, you need to set current template language with the filter <code>template_dictionary_language</code>. For users of Polylang, it is already integrated in this plugin, the current template language is the Polylang current language slug.</p>
<h4>Setup available languages</h4>
<p><strong>If you have a multilingual site</strong>, you also need to set available languages with the filter <code>template_dictionary_languages</code>. Again, if Polylang is activated, these available languages consist of Polylang languages slugs.</p>
<p>If your site is not multilingual, there is only one available language – the default language.</p>
<h4>Use JS object</h4>
<p>To generate JavaScript dictionary object, you need to define <code>TMPL_DICT_JS_VAR_NAME</code> constant. Add to <code>wp_config.php</code>:</p>
<pre><code>define( 'TMPL_DICT_JS_VAR_NAME', 'dict' );
</code></pre>
<p>Then you can use it in JS:</p>
<pre><code>$('#some-element').text( dict.the_code );
</code></pre>


Template Dictionary

A plugin for developers which provides template variables dictionary editable in backend.

Abdullah Khalfan

akirak

<p>Create your own custom variables to manage information on your website such as:</p>
<ul>
<li>Phone numbers</li>
<li>Addresses</li>
<li>Social media links</li>
<li>HTML snippets</li>
<li>And anything else<br />
test</li>
</ul>
<p>Easily access them globally in WordPress and PHP.</p>
<h4>Why you need it</h4>
<p>Rather than having to change something like an email address across multiple pages, you can do it in one place. Avoid the pitfalls of hard coding information in your WordPress theme that is likely to change.</p>
<h4>Why it’s better</h4>
<ul>
<li>Your variables are stored and retrieved locally without any calls to the database. That means faster load times for your pages!</li>
<li>Variables can be accessed easily in PHP from the global scope.</li>
</ul>
<h3>Usage</h3>
<p>Display your variables using the shortcode syntax:</p>
<pre><code>[cgv variable-name]
</code></pre>
<p>Or using the superglobal in PHP:</p>
<pre><code><?php echo $GLOBALS['cgv']['variable-name'] ?>
</code></pre>


Custom Global Variables

Easily create custom variables that can be accessed globally in Wordpress and PHP. Retrieval of information is extremely fast, with no database calls.

Template Dictionary vs Custom Global Variables