Ashok Dhamija

TG Customized Tags plugin provides a fully configurable tag-cloud through widget and shortcodes to display tags, categories or other taxonomy.
Once installed, the settings of the TG Customized Tags plugin would be available for being changed from the ‘TG Customized Tags’ option in the ‘Settings’ menu on the admin screen (back-end) of your WordPress website or blog.
The tags and categories can be displayed to users in many different ways (in the following description, the word “tags” also includes “categories”):
<ul>
<li>Change number of tags to be displayed – all tags or default 45 or any other number of your choice.</li>
<li>Show only specific tags (selected by tag-IDs) of your choice and none else.</li>
<li>Exclude specific tags from being shown, while showing others, the total number being limited by number of your choice.</li>
<li>Show tags in a list (each tag on a new line) or in a flat format.</li>
<li>In flat format, select which character(s) should separate two adjoining tags.</li>
<li>Select the ordering of tags – whether by tag-count (number of posts with a tag) or by tag-name (alphabetically).</li>
<li>Within above selection, choose whether to order tags in ascending, descending or random manner.</li>
<li>Select whether tags, or categories or link-categories should be displayed in the tag-cloud.</li>
<li>Select what should be the smallest and largest font-sizes to display tags in cloud. Both these font-sizes can be equal also, which will show all tags with same font-size.</li>
<li>Select what is the unit for font-size, whether point, pixels, mm, cm, picas, percent, etc.</li>
</ul>
TG Customized Tags plugin allows you to change or set 11 attributes of the tag-cloud, in the manner mentioned above, through the administrative options page in your WordPress website or blog. These settings will be remembered by WordPress. You can change these settings any time. You can also Reset all settings to the Default settings that came with the WordPress installation, at any time you want. If, during the process of changing these tag-settings, you change your mind, you can simple Cancel the changes made by clicking a button. A user-friendly screen with full-guidance on the screen helps you to decide what to choose. Moreover, the Plugin Page (http://www.tekgazet.com/tg-customized-tags-plugin) contains further detailed help with all possible plugin options explained with examples.
TG Customized Tags plugin provides two shortcodes [tg_customized_tags_default] and [tg_customized_tags_current]. The first shortcode works with the default tag-cloud settings (that came with your WordPress installation). The second shortcode works with the current tag-cloud settings as changed by you through this plugin. In addition to these, each shortcode allows you to customize and configure 11 different attributes of the tag-cloud by setting any permissible values, while inserting the shortcode in your post or page in your WordPress website. Thus, literally, there can be hundreds or thousands of combinations in which you can insert either of these two shortcodes in your posts and pages in order to display tag-cloud to your visitors in the manner and format you want. It goes without saying that the shortcode inserted in a post or page can be entirely different (due to different combination of 11 attributes) from the shortcode inserted in any other post or page of your website. Thus, you get complete flexibility. You are in full control to configure how your tags should appear in a particular post, page or widget in the sidebar.
After you change and save your settings for the tag-cloud in the TG Customized Tags plugin settings, you can simply use the normal or default tag-cloud widget on your website (which is available on the Appearance -> Widgets admin menu of every WordPress site by default) and the settings entered by you in this plugin will be automatically applied to that tag-cloud widget. Thus, you don’t have to change any additional settings for the widget. Moreover, if you use the [tg_customized_tags_current] shortcode provided by this plugin, it will also use the settings entered and saved by you in this plugin.
This plugin does not require any Flash, Javascript, CSS, etc. Due to this reason, this plugin is very light and moreover, it is also compatible with any device with a modern browser. It will not conflict with other plugins. In fact, since this plugin does not generate its own HTML tags for the tag-cloud and merely uses or changes the settings for tag-cloud in WordPress, it may work in complete harmony with even those other plugins that deal with the same issue, i.e., tags and categories.
Thus, TG Customized Tags plugin gives you the full freedom to display fully configurable tags and categories in the sidebar of your website (through the usual or default tag-cloud widget, which will now use your own settings) and/or to display fully configurable tags and categories in any of your posts or pages (through two different shortcodes). You can choose either or both functionalities, and each can be fully configured and customized. This explain why name of this plugin includes Customized Tags.

TG Customized Tags

Display fully customized and configurable tags, categories or other taxonomy in tag-cloud with widget and shortcodes.

John Huebner

<h4>Compatibility</h4>
This ACF field type is compatible with: 
* ACF 5 
* ACF 6
This is an add on plugin for Advanced Custom Fields (ACF) 5 or 6. This plugin will not work if ACF is not installed and active. This plugin may work in a limited capacity if the repeater field is not avilable.
Ever needed to give a client a way to edit the appearence of text without wanting to give them a full blown WYSIWYG editor? Need something less than a WYSYWIG but more than a text or textarea field that you can configure the way you need it to work with the features you need it to have?
This add on for ACF5 adds <a href="https://github.com/yabwe/medium-editor" rel="nofollow ugc">MediumEditor</a> as an ACF field. 
Each field instance is configurable, and each field instance has its own settings. Many of the options 
available in MediumEditor are supported, including the creation of custom buttons using <a href="https://github.com/arcs-/MediumButton" rel="nofollow ugc">MediumButton</a>. It is also possible using either a configuration 
setting or a filter to alter the MediumEditor Theme. Some of the available options are covered below. 
For more information on MediumEditor and MediumButton, see the description of these libaries at the links provided.
For more information see 
<a href="https://wordpress.org/plugins/medium-editor-field-for-acf/other_notes" rel="ugc">Other Notes</a> and 
<a href="https://wordpress.org/plugins/medium-editor-field-for-acf/screenshots" rel="ugc">Screenshots</a>
Medium Editor needs your help!. This plugin depends <a href="https://github.com/yabwe/medium-editor" rel="nofollow ugc">Medium Editor</a> which is the JavaScript package that powers this ACF Add On. I do not maintain this package. This pluig is simply an implementation of it for ACF. <a href="https://github.com/yabwe/medium-editor/issues/1503" rel="nofollow ugc">Medium Editor is looking for contributors</a>. Without people to help maintain and improve it Medium Editor could fade away and if that happens this plugin will also no longer be possible.
<h3>Github Repository</h3>
This plugin is also on GitHub 
<a href="https://github.com/Hube2/acf-medium-editor" rel="nofollow ugc">https://github.com/Hube2/acf-medium-editor</a>
<h3>Field Settings</h3>
The following is an explanation of the fields, not including the ones that should be self explanatory.
Buttons: These are the buttons that are included in <a href="https://github.com/yabwe/medium-editor#buttons" rel="nofollow ugc">MediumEditor</a>. 
Select the buttons you want to include in each editor instance.
Custom Buttons: This is the main reason that I created this plugin. This field supports adding 
custom buttons using <a href="https://github.com/arcs-/MediumButton#html-buttons" rel="nofollow ugc">MediumButton</a>. 
Please note that if any of the main fields (Name, Label, HTML Tag) are empty that the entire 
button will be ignored.
Name: This is then name of the button and will be used when instaniating the MediumButton Object. 
The button name must be unique and cannot be one of the buttons already included in MediumEditor, a 
button of the same name as one of the standard button in Medium Editor will not override that button 
if it is also included. I do not know what the effects of custom characters in the name will be. 
Please report any bugs and I will look into adding something to clean up characters or find some other work-around for any that cause errors.
Label: This is the label that will appear in the button bar. This field allows HTML. 
Please make sure it is valid html (I do not validate the html you enter). Invalid markup will probably 
break the button bar or the entire admin. MediumButton also supports using icons for buttons. 
If you want to use icons in your buttons then it is your responsibility to make sure the icon font set is 
available for use in the admin of your site.
HTML Tag: Enter the html tag that will be inserted by this button. Only non-empty html tags are allowed. 
Most valid HTML tags are supported. If an invalid HTML tag is entered then the button will be ignored.
I’m not sure at this time what effect some of the tags will have in the editor. I haven’t tried them all 
if you run into issues let me know and I’ll need to make a decision on wheter to try to fix it or remove 
the tag(s) from the allowed list.
The currently supported tags are: abbr, acronym, address, article, asside, b, 
bdi, bdo, blockquote, button, caption, cite, code, del, details, dfn, 
div, em, footer, h1, h2, h3, h4, h5, h6, header, 
i, ins, main, mark, meta, p, pre, q, s, samp, section, small, span, 
strong, sub, sup, summary, time, u, var, wbr
Attributes: Add attributes to the html tag. Attibute names must be valid (they must 
begin with a letter and contain only letter, numbers, underscores and dashes. Attribute 
values must not contain double quotes (“) any attributes that do not conform to these 
rules will be ignored. Please note that beyond this, attribute names and values are not 
validated. I do not know what effect invalid entries will have on your admin. Like other 
values, if you find something that causes an issue, open one and I’ll see what needs to be done.
Other MediumEditor Options: This is a selection of other 
<a href="https://github.com/yabwe/medium-editor#core-options" rel="nofollow ugc">Core Options</a> available for 
MediumEditor with the exception of allowBreakInSingleLineInput (see below). Please 
see the MediumEditor documentation for information on each of the other options. Selecting 
an option will set that option’s value to true, unselecting the value will set it to false.
allowBreakInSingleLineInput: This is an option added specifically for use with WP. 
If you set disableReturn on then the medium editor acts like a single line input field. Setting 
allowBreakInSingleLineInput allows editors to manually type in tags into these 
single line fields to create line breaks.
<h3>Medium Editor Theme</h3>
MediumEditor fields will use the WordPress theme created specifically for the this plugin unless you change it. 
You can alter the theme used for all MediumEditor fields, this is not something that you can apply to only 
some fields. You can change the theme on your site in one of two ways:
1) wp-config.php 
Add the following code to your wp-cofig.php file
<pre><code>define('MEDIUM_EDITOR_THEME', 'beagle');
</code></pre>
2) filter 
Add the following code to your functions.php file or wherever you would add such a filter
<pre><code>add_filter('medium-editor-theme', 'my_medium_editor_theme_function');
function my_medium_editor_theme_function($theme) {
 $theme = 'beagle';
 return $theme;
}
</code></pre>
Theme name in the above code is one of the following themes currently supported by MediumEditor: 
beagle, bootstrap, default, flat, mani, roman, tim
For more information see <a href="https://github.com/yabwe/medium-editor#mediumeditor" rel="nofollow ugc">MediumEditor</a> and 
<a href="https://github.com/arcs-/MediumButton#mediumbutton" rel="nofollow ugc">MediumButton</a>
<h3>Custom Editor Styles</h3>
The styles used in the medium editor for elementa is inherited from WP. If you want to override these styles 
create a file named “medium-editor-syle.css” in your theme folder. If this file exists is will be 
automatcially enqueued on all pages where ACF fields appear.
<h3>Add Custom Buttons in Code</h3>
This filter is applied to the custom buttons before they are validated as having all the correct 
requirements that are given when creating a custom button in the field settings for a Medium Editor Field.
Hooks
<ol>
<li>acf/medium-editor-field/custom-buttons – filter for every field </li>
<li>acf/medium-editor-field/custom-buttons/name={$field_name} – filter for specific field based on it’s name</li>
<li>acf/medium-editor-field/custom-buttons/key={$field_key} – filter for specific field based on it’s key</li>
</ol>
Parameters
<ol>
<li>$buttons – an array of button options</li>
<li>
$field – an array containing all the fields settings for the field being loaded
// functions.php
function my_custom_buttons($buttons, $field) { 
 $buttons[] = array( 
 ‘name’ => ‘red’, 
 ‘label’ => ‘Red”‘, 
 ‘attributes’ => array( 
 ‘name’ => ‘style’, 
 ‘value’ => ‘color: #F00;’ 
 ) 
 ); 
 return $buttons; 
} 
add_filter(‘acf/medium-editor-field/custom-buttons’, ‘my_custom_buttons’, 10, 2);
</li>
</ol>
<h3>Filter Buttons</h3>
This filter is applied to the list of buttons that will be shown. This list will contain the “name” 
of each standard button as well as the “name” of each custom button that has been set up for the field. 
Please note that only valid button names can be used here. See medium editor’s list of available 
buttons.
Hooks
<ol>
<li>acf/medium-editor-field/buttons – filter for every field </li>
<li>acf/medium-editor-field/buttons/name={$field_name} – filter for specific field based on it’s name</li>
<li>acf/medium-editor-field/buttons/key={$field_key} – filter for specific field based on it’s key</li>
</ol>
Parameters
<ol>
<li>$buttons – an array of button options</li>
<li>
$field – an array containing all the fields settings for the field being loaded
// functions.php
function my_custom_buttons($buttons, $field) { 
 // add underline button to all medium editor fields 
 // set both the index and the value of the array element 
 if (!isset($buttons[‘underline’])) { 
 $buttons[‘underline’] = ‘underline’; 
 } 
 // unset strikethrough if it is set 
 if (isset($buttons[‘strikethrough’])) { 
 unset($buttons[‘strikethrough’]); 
 } 
 return $buttons; 
} 
add_filter(‘acf/medium-editor-field/buttons’, ‘my_buttons’, 10, 2);
</li>
</ol>

ACF Medium Editor Field

This plugin gives WordPress what it has been missing for some time – a text field that is more than just a textarea and less that tinyMCE. And it does it flawlessly! Recommended.

TG Customized Tags vs ACF Medium Editor Field