rob1n

<p>When you use the <code>[smarter-archives]</code> shortcode anywhere in a post or a page, it gets replaced by a listing of every year since you started posting, with a list of links to each month for that year. However, the plugin is smart enough to know if you didn’t create any content in any given month, and doesn’t make a link for that month. See the <strong>Screenshots</strong> section for an example of it in action.</p>
<p>See the <strong>Usage</strong> section for a complete list of the arguments the shortcode takes, and how you can use them to customize your archives listing.</p>
<p>The month names are <a href="https://codex.wordpress.org/I18n_for_WordPress_Developers" rel="nofollow ugc">internationalized with the WordPress translation API</a>. A POT file is included, and if you want to translate please feel free to do so and <a href="https://github.com/robinadr/smarter-archives/pulls" rel="nofollow ugc">submit a new pull request</a> on GitHub. If you do not know how to use GitHub, you can also <a href="http://robinadr.com/contact" rel="nofollow ugc">contact me directly</a>. Here are the translations that have been done so far:</p>
<ul>
<li>Dutch (nl_NL)</li>
<li>French (fr_FR)</li>
<li>German (de_DE)</li>
<li>Italian (it_IT)</li>
<li>Spanish (es_ES)</li>
<li>Russian (ru_RU)</li>
</ul>
<p>The original concept for this plugin comes from a plugin by Justin Blanton.</p>
<h3>Usage</h3>
<p>The <code>[smarter-archives]</code> shortcode takes these arguments (default values included):</p>
<ul>
<li><code>mode</code> (default: <code>output</code>) — if it’s set to <code>output</code>, the plugin prints the listing. Set it to <code>false</code> to return the value</li>
<li><code>wrapper_class</code> (default: <code>smart-archives</code>) — class given to the tag wrapped around the listing (<code><div></code> by default)</li>
<li><code>wrapper_tag</code> (default: <code>div</code>) — tag wrapped around the listing</li>
<li><code>year_link_class</code> (default: <code>year-link</code>) — class given to each year links</li>
<li><code>year_tag</code> (default: <code>p</code>) — tag around each year group</li>
<li><code>year_class</code> (default: none) — class for the tag around each year group</li>
<li><code>after_year</code> (default: <code>:</code>) — value after the year and before the list of months</li>
<li><code>month_link_class</code> (default: <code>month-link</code>) — class given to each month link</li>
<li><code>month_tag</code> (default: <code>span</code>) — tag around each month</li>
<li><code>after_month</code> (default: <code>&nbsp;</code>) — spacer between months</li>
<li><code>empty_month_class</code> (default: <code>empty-month</code>) — class applied to empty months (can use this to gray them out)</li>
<li><code>order</code> (default: <code>DESC</code>) — order the years are shown in (<code>ASC</code> for ascending, <code>DESC</code> for descending)</li>
</ul>
<p><strong>Advanced Usage</strong></p>
<p>There is a function, <code>get_smarter_archives()</code>, that returns the raw array with the years, months, and post counts. You can use this for ultimate customization.</p>
<p><strong>Example Usage</strong></p>
<pre><code>[smarter-archives order="DESC" after_month="&bull;"]<h3>License</h3>
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
</code></pre>
<p>A full version of the license is included with the plugin in <code>license.txt</code>.</p>


Smarter Archives

Easily navigate the yearly and monthly archives of your blog.

webvitaly

<ul>
<li><strong><a href="http://web-profile.net/wordpress/plugins/" title="WordPress Pro plugins" rel="nofollow ugc">WordPress Pro plugins</a></strong></li>
<li><strong><a href="http://web-profile.net/wordpress/plugins/extra-shortcodes/" title="Extra Shortcodes" rel="nofollow ugc">Extra Shortcodes</a></strong></li>
<li><strong><a href="http://web-profile.net/donate/" title="Donate" rel="nofollow ugc">Donate</a></strong></li>
<li><strong><a href="https://github.com/webvitalii/extra-shortcodes" title="Fork" rel="nofollow ugc">GitHub</a></strong></li>
</ul>
<h4>Shortcodes:</h4>
<ul>
<li><code>[extra_archives]</code> – list of monthly archives links sorted by date;</li>
<li><code>[extra_archives type="yearly"]</code> – list of yearly archives links;</li>
<li><code>[extra_archives type="monthly"]</code> – list of monthly archives links;</li>
<li><code>[extra_archives type="weekly"]</code> – list of weekly archives links;</li>
<li><code>[extra_archives type="daily"]</code> – list of daily archives links;</li>
<li><code>[extra_archives type="postbypost"]</code> – list of all posts links sorted by date;</li>
<li><code>[extra_archives type="alpha"]</code> –  list of all posts links sorted by title;</li>
<li><code>[extra_taxonomies]</code> – list of categories, tags or any other taxonomies;</li>
<li><code>[bloginfo show="name"]</code> – <a href="https://codex.wordpress.org/Function_Reference/get_bloginfo" rel="nofollow ugc">bloginfo params</a>;</li>
<li><code>[date format="l jS \\of F Y h:i:s A"]</code> – Monday 23rd April 2012 09:37:57 AM; <a href="http://php.net/manual/en/function.date.php" rel="nofollow ugc">php date format params</a>;</li>
<li><code>[date format="l jS \\of F Y h:i:s A" timestamp="+2 years +3 months -20 days -10 hours +30 minutes"]</code> – Thursday 3rd July 2014 06:52:57 AM; <a href="http://www.php.net/manual/en/datetime.formats.relative.php" rel="nofollow ugc">relative datetime formats</a>;</li>
<li><code>[date format="h:i:s A" use_wordpress_timezone="1"]</code> – use WordPress timezone from Settings section;</li>
<li><code>[date_i18n format="l jS \\of F Y h:i:s A" timestamp="+2 years +3 months -20 days -10 hours +30 minutes"]</code> – Четвер, 3 Липня 2014 06:52:57; shortcode based on <a href="https://codex.wordpress.org/Function_Reference/date_i18n" rel="nofollow ugc">date_i18n</a>;</li>
<li><code>[time format="h:i:s A"]</code> – 01:35:08 PM; <a href="http://php.net/manual/en/function.date.php" rel="nofollow ugc">php time format params</a>;</li>
<li><code>[year]</code> – 2012, <code>[year plus="3"]</code> – 2015, <code>[year minus="2"]</code> – 2010;</li>
<li><code>[month]</code> – 4 (in April), <code>[month plus="10"]</code> – 2, <code>[month minus="8"]</code> – 8;</li>
<li><code>[month_name]</code> – April, <code>[month_name plus="10"]</code> – February, <code>[month_name minus="8"]</code> – August;</li>
<li><code>[day]</code> – 8, <code>[day plus="3"]</code> – 11, <code>[day minus="2"]</code> – 6;</li>
<li><code>[weekday]</code> – Monday, <code>[weekday plus="5"]</code> – Saturday, <code>[weekday minus="5"]</code> – Wednesday;</li>
<li><code>[hours]</code>, <code>[minutes]</code>, <code>[seconds]</code>;</li>
</ul>
<p><strong><a href="https://wordpress.org/plugins/extra-shortcodes/other_notes/" title="Extra Shortcodes" rel="ugc">more info about shortcodes</a></strong></p>
<h4>Useful:</h4>
<ul>
<li><a href="https://wordpress.org/plugins/page-list/" title="list of pages with shortcodes" rel="ugc">“Page-list” – show list of pages with shortcodes</a></li>
<li><a href="https://wordpress.org/plugins/iframe/" title="embed content" rel="ugc">“Iframe” – embed content</a></li>
<li><a href="http://web-profile.net/wordpress/plugins/" title="WordPress Pro plugins" rel="nofollow ugc">WordPress Pro plugins</a></li>
</ul>
<h4>Parameters for [extra_archives]:</h4>
<ul>
<li><code>[extra_archives]</code> – list of monthly archives links sorted by date;</li>
<li><code>[extra_archives type="yearly"]</code> – list of yearly archives links;</li>
<li><code>[extra_archives type="monthly"]</code> – list of monthly archives links;</li>
<li><code>[extra_archives type="weekly"]</code> – list of weekly archives links;</li>
<li><code>[extra_archives type="daily"]</code> – list of daily archives links;</li>
<li><code>[extra_archives type="postbypost"]</code> – list of all posts links sorted by date;</li>
<li><code>[extra_archives type="alpha"]</code> –  list of all posts links sorted by title;</li>
<li><strong>limit</strong> – how many links to be included in the list: <code>[extra_archives limit="10"]</code>; by default all links are shown: <code>[extra_archives limit=""]</code>;</li>
<li><strong>show_post_count</strong> – display counter of posts in the archive: <code>[extra_archives show_post_count="1"]</code>; by default counter is not shown: <code>[extra_archives show_post_count="0"]</code>;</li>
<li><strong>order</strong> – how to sort archives links: <code>[extra_archives order="ASC"]</code>; by default links are sorted by descending order (Z-A): <code>[extra_archives order="DESC"]</code>;</li>
</ul>
<p>[extra_archives] is based on <a href="https://codex.wordpress.org/Function_Reference/wp_get_archives" rel="nofollow ugc">wp_get_archives function</a>.</p>
<h4>Parameters for [extra_taxonomies]:</h4>
<ul>
<li><strong>orderby</strong> – sort list by specific field: <code>[extra_taxonomies order="count"]</code>; by default list is sorted by name: <code>[extra_taxonomies order="name"]</code>; possible values: ID, name, slug, count, term_group;</li>
<li><strong>order</strong> – the sort order of the list of pages (either ascending or descending): <code>[extra_taxonomies order="DESC"]</code>; by default: <code>[extra_taxonomies order="ASC"]</code>; possible values: ASC, DESC;</li>
<li><strong>show_count</strong> – display counter of posts in the list: <code>[extra_taxonomies show_count="1"]</code>; by default counter is not shown: <code>[extra_taxonomies show_count="0"]</code>;* <strong>limit</strong> – how many links to be included in the list: <code>[extra_archives limit="10"]</code>; by default all links are shown: <code>[extra_archives limit=""]</code>;</li>
<li><strong>hide_empty</strong> – show or hide empty categories or taxonomies: <code>[extra_taxonomies hide_empty="0"]</code>; by default empty categories are hidden: <code>[extra_taxonomies hide_empty="1"]</code>;</li>
<li><strong>use_desc_for_title</strong> – use description for title: <code>[extra_taxonomies use_desc_for_title="0"]</code>; by default the description is used as link title: <code>[extra_taxonomies use_desc_for_title="1"]</code>;</li>
<li><strong>child_of</strong> – only display categories that are children of the category identified by this parameter: <code>[extra_taxonomies child_of="77"]</code>;</li>
<li><strong>exclude</strong> – exclude one or more categories (comma-separated list of category ids) from the results: <code>[extra_taxonomies exclude="5,7,9"]</code>;</li>
<li><strong>exclude_tree</strong> – exclude category-tree (comma-separated list of category ids) from the results: <code>[extra_taxonomies exclude_tree="5,7,9"]</code>; The parameter include must be empty. If the hierarchical parameter is true, then use exclude instead of exclude_tree.</li>
<li><strong>include</strong> – only include the categories detailed in a comma-separated list by category id: <code>[extra_taxonomies include="5,7,9"]</code>;</li>
<li><strong>hierarchical</strong> – list is hierarchical (tree-like) or flat: <code>[extra_taxonomies hierarchical="0"]</code>; by default the list is hierarchical: <code>[extra_taxonomies hierarchical="1"]</code>;</li>
<li><strong>number</strong> – sets the number of categories to display: <code>[extra_taxonomies number="10"]</code>; by default the number is unlimited: <code>[extra_taxonomies number=""]</code>;</li>
<li><strong>depth</strong> – how many levels in the hierarchy of pages are to be included in the list: <code>[extra_taxonomies depth="3"]</code>; by default the depth is unlimited: <code>[extra_taxonomies depth="0"]</code>;</li>
<li><strong>taxonomy</strong> – show list of registered taxonomy: <code>[extra_taxonomies taxonomy="post_tag"]</code>; by default shows the list of categories: <code>[extra_taxonomies taxonomy="category"]</code>;</li>
</ul>
<p>[extra_taxonomies] is based on <a href="https://codex.wordpress.org/Template_Tags/wp_list_categories" rel="nofollow ugc">wp_list_categories function</a>.</p>
<h4>Parameters for [bloginfo]:</h4>
<ul>
<li><code>[bloginfo show="name"]</code> – <a href="https://codex.wordpress.org/Function_Reference/get_bloginfo" rel="nofollow ugc">bloginfo params</a>;</li>
<li><code>[site_name]</code> – Name of the site;</li>
<li><code>[site_desc]</code> – Description of the site;</li>
<li><code>[site_url]</code> – http://site.url;</li>
<li>
<p><code>[wp_version]</code> – 4.5 (WordPress version);</p>
<p>[bloginfo] is based on <a href="https://codex.wordpress.org/Function_Reference/bloginfo" rel="nofollow ugc">bloginfo function</a>.</p>
</li>
</ul>
<h4>Parameters for [date]:</h4>
<ul>
<li><code>[date format="l jS \\of F Y h:i:s A"]</code> – Monday 23rd April 2012 09:37:57 AM; <a href="http://php.net/manual/en/function.date.php" rel="nofollow ugc">php date format params</a>;</li>
<li><code>[date format="l jS \\of F Y h:i:s A" timestamp="+2 years +3 months -20 days -10 hours +30 minutes"]</code> – Thursday 3rd July 2014 06:52:57 AM; <a href="http://www.php.net/manual/en/datetime.formats.relative.php" rel="nofollow ugc">relative datetime formats</a>;</li>
<li><code>[date format="h:i:s A" use_wordpress_timezone="1"]</code> – use WordPress timezone from Settings section;</li>
<li><code>[date_i18n format="l jS \\of F Y h:i:s A" timestamp="+2 years +3 months -20 days -10 hours +30 minutes"]</code> – Четвер, 3 Липня 2014 06:52:57; shortcode based on <a href="https://codex.wordpress.org/Function_Reference/date_i18n" rel="nofollow ugc">date_i18n</a>;</li>
<li><code>[time format="h:i:s A"]</code> – 01:35:08 PM; <a href="http://php.net/manual/en/function.date.php" rel="nofollow ugc">php time format params</a>;</li>
<li><code>[year]</code> – 2012, <code>[year plus="3"]</code> – 2015, <code>[year minus="2"]</code> – 2010;</li>
<li><code>[month]</code> – 4 (in April), <code>[month plus="10"]</code> – 2, <code>[month minus="8"]</code> – 8;</li>
<li><code>[month_name]</code> – April, <code>[month_name plus="10"]</code> – February, <code>[month_name minus="8"]</code> – August;</li>
<li><code>[day]</code> – 8, <code>[day plus="3"]</code> – 11, <code>[day minus="2"]</code> – 6;</li>
<li><code>[weekday]</code> – Monday, <code>[weekday plus="5"]</code> – Saturday, <code>[weekday minus="5"]</code> – Wednesday;</li>
<li><code>[hours]</code>, <code>[minutes]</code>, <code>[seconds]</code>;</li>
</ul>


Extra Shortcodes

[extra_archives], [extra_taxonomies], [bloginfo show="name"], [date format="l jS \of F Y"], [date_i18n], [time]

Smarter Archives vs Extra Shortcodes