rob1n

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 Screenshots section for an example of it in action.
See the Usage section for a complete list of the arguments the shortcode takes, and how you can use them to customize your archives listing.
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:
<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>
The original concept for this plugin comes from a plugin by Justin Blanton.
<h3>Usage</h3>
The <code>[smarter-archives]</code> shortcode takes these arguments (default values included):
<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>
Advanced Usage
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.
Example Usage
<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>
A full version of the license is included with the plugin in <code>license.txt</code>.

Smarter Archives

Easily navigate the yearly and monthly archives of your blog.

webvitaly

<ul>
<li><a href="http://web-profile.net/wordpress/plugins/sitekit/" title="Plugin page" rel="nofollow ugc">Sitekit</a></li>
<li><a href="http://web-profile.net/donate/" title="Support the development" rel="nofollow ugc">Donate</a></li>
<li><a href="https://github.com/webvitalii/sitekit" title="Fork" rel="nofollow ugc">GitHub</a></li>
</ul>
<h4>Settings:</h4>
<ul>
<li>Google Analytics code</li>
<li>Show/hide google analytics code if user is logged in</li>
<li>Head code</li>
<li>Footer code</li>
</ul>
<h4>Widgets:</h4>
<ul>
<li>Archives</li>
<li>Categories</li>
<li>Pages</li>
<li>Search</li>
</ul>
<h4>Shortcodes:</h4>
<ul>
<li><code>[sitekit_posts]</code></li>
<li><code>[sitekit_archives]</code></li>
<li><code>[sitekit_categories]</code></li>
<li><code>[sitekit_bloginfo]</code></li>
<li><code>[sitekit_iframe]</code></li>
</ul>
<h4>Parameters for [sitekit_posts]:</h4>
<ul>
<li>post_type – show posts associated with certain type: <code>[sitekit_posts post_type="page"]</code>; by default posts are shown: <code>[sitekit_posts post_type="post"]</code>; Possible params: post | page | revision | attachment | nav_menu_item | any | your_custom_post_type</li>
<li>orderby – the column to use for ordering posts list: <code>[sitekit_posts orderby="id"]</code>; by default list is sorted by date: <code>[sitekit_posts orderby="date"]</code>; Possible params: modified | title | name | ID | rand</li>
<li>order – how to sort posts list: <code>[sitekit_posts order="DESC"]</code>; by default list is sorted by ascending order (A-Z): <code>[sitekit_posts order="ASC"]</code>;</li>
<li>posts_per_page – how many posts to show in the list: <code>[sitekit_posts posts_per_page="50"]</code>; by default: <code>[sitekit_posts posts_per_page="100"]</code>;</li>
</ul>
[sitekit_posts] is based on <a href="https://codex.wordpress.org/Class_Reference/WP_Query" rel="nofollow ugc">WP_Query class</a>.
<h4>Parameters for [sitekit_archives]:</h4>
<ul>
<li><code>[sitekit_archives]</code> – list of monthly archives links sorted by date;</li>
<li><code>[sitekit_archives type="yearly"]</code> – list of yearly archives links;</li>
<li><code>[sitekit_archives type="monthly"]</code> – list of monthly archives links;</li>
<li><code>[sitekit_archives type="weekly"]</code> – list of weekly archives links;</li>
<li><code>[sitekit_archives type="daily"]</code> – list of daily archives links;</li>
<li><code>[sitekit_archives type="postbypost"]</code> – list of all posts links sorted by date;</li>
<li><code>[sitekit_archives type="alpha"]</code> – list of all posts links sorted by title;</li>
<li>limit – how many links to be included in the list: <code>[sitekit_archives limit="10"]</code>; by default all links are shown: <code>[sitekit_archives limit=""]</code>;</li>
<li>format – format for the archive: <code>[sitekit_archives format="option"]</code> – show as a dropdown; by default unordered list is shown: <code>[sitekit_archives format="html"]</code>;</li>
<li>show_post_count – display counter of posts in the archive: <code>[sitekit_archives show_post_count="1"]</code>; by default counter is not shown: <code>[sitekit_archives show_post_count="0"]</code>;</li>
<li>order – how to sort archives links: <code>[sitekit_archives order="ASC"]</code>; by default links are sorted by descending order (Z-A): <code>[sitekit_archives order="DESC"]</code>;</li>
</ul>
[sitekit_archives] is based on <a href="https://codex.wordpress.org/Function_Reference/wp_get_archives" rel="nofollow ugc">wp_get_archives function</a>.
<h4>Parameters for [sitekit_categories]:</h4>
<ul>
<li>orderby – the column to use for ordering categories list: <code>[sitekit_categories orderby="id"]</code>; by default list is sorted by title: <code>[sitekit_categories orderby="name"]</code>;</li>
<li>order – how to sort categories list: <code>[sitekit_categories order="DESC"]</code>; by default list is sorted by ascending order (A-Z): <code>[sitekit_categories order="ASC"]</code>;</li>
<li>show_count – display counter of posts in the categories list: <code>[sitekit_categories show_count="1"]</code>; by default counter is not shown: <code>[sitekit_categories show_count="0"]</code>;</li>
<li>hide_empty – the column to use for ordering categories list: <code>[sitekit_categories hide_empty="0"]</code>; by default empty categories are hidden: <code>[sitekit_categories hide_empty="1"]</code>;</li>
<li>hierarchical – show tree-like categories list: <code>[sitekit_categories hierarchical="0"]</code>; by default the list is hierarchical: <code>[sitekit_categories hierarchical="1"]</code>;</li>
<li>depth – how many levels to include in categories list: <code>[sitekit_categories depth="5"]</code>; by default depth is unlimited: <code>[sitekit_categories depth="0"]</code>;</li>
<li>taxonomy – which taxonomy to show in the list: <code>[sitekit_categories taxonomy="post_tag"]</code>; by default categories are shown: <code>[sitekit_categories taxonomy="category"]</code>;</li>
<li>child_of – term ID to retrieve child terms of: <code>[sitekit_categories child_of="77"]</code>; by default all categories are shown: <code>[sitekit_categories child_of="0"]</code>;</li>
<li>exclude – comma/space-separated string of term IDs to exclude: <code>[sitekit_categories exclude="77"]</code>; by default all categories are shown: <code>[sitekit_categories exclude=""]</code>;</li>
<li>exclude_tree – comma/space-separated string of term IDs to exclude, along with their descendants: <code>[sitekit_categories exclude_tree="77"]</code>; by default all categories are shown: <code>[sitekit_categories exclude_tree=""]</code>;</li>
</ul>
[sitekit_categories] is based on <a href="https://developer.wordpress.org/reference/functions/wp_list_categories/" rel="nofollow ugc">wp_list_categories function</a>.
<h4>Parameters for [sitekit_bloginfo]:</h4>
<ul>
<li><code>[sitekit_bloginfo show="name"]</code> – <a href="https://developer.wordpress.org/reference/functions/bloginfo/" rel="nofollow ugc">sitekit_bloginfo params</a>;</li>
</ul>
[sitekit_bloginfo] is based on <a href="https://developer.wordpress.org/reference/functions/bloginfo/" rel="nofollow ugc">bloginfo function</a>.
<h4>Parameters for [sitekit_iframe]:</h4>
<ul>
<li>src – source of the iframe: <code>[sitekit_iframe src="http://www.youtube.com/embed/4qsGTXLnmKs"]</code>; by default src=”http://www.youtube.com/embed/4qsGTXLnmKs”;</li>
<li>width – width in pixels or in percents: <code>[sitekit_iframe width="100%"]</code> or <code>[sitekit_iframe width="600"]</code>; by default width=”100%”;</li>
<li>height – height in pixels: <code>[sitekit_iframe height="500"]</code>; by default height=”500″;</li>
<li>scrolling – with or without the scrollbar: <code>[sitekit_iframe scrolling="no"]</code>; by default scrolling=”yes”;</li>
<li>frameborder – with or without the frame border: <code>[sitekit_iframe frameborder="0"]</code>; by default frameborder=”0″;</li>
<li>marginheight – height of the margin: <code>[sitekit_iframe marginheight="0"]</code>; removed by default;</li>
<li>marginwidth – width of the margin: <code>[sitekit_iframe marginwidth="0"]</code>; removed by default;</li>
<li>allowtransparency – allows to set transparency of the iframe: <code>[sitekit_iframe allowtransparency="true"]</code>; removed by default;</li>
<li>id – allows to add the id of the iframe: <code>[sitekit_iframe id="custom_id"]</code>; removed by default;</li>
<li>class – allows to add the class of the iframe: <code>[sitekit_iframe class="custom_class"]</code>; by default class=”iframe-class”;</li>
<li>style – allows to add the css styles of the iframe: <code>[sitekit_iframe style="margin-left:-30px;"]</code>; removed by default;</li>
<li>any_other_param – allows to add new parameter of the iframe <code>[sitekit_iframe any_other_param="any_value"]</code>;</li>
<li>any_other_empty_param – allows to add new empty parameter of the iframe (like “allowfullscreen” on youtube) <code>[sitekit_iframe any_other_empty_param=""]</code>;</li>
</ul>
<h4>Parameters for [sitekit_menu]:</h4>
The <code>[sitekit_menu]</code> shortcode allows you to display a custom menu. It supports all the parameters of the WordPress <a href="https://developer.wordpress.org/reference/functions/wp_nav_menu/" rel="nofollow ugc">wp_nav_menu()</a> function.
<ul>
<li>menu – The menu that should be displayed. Accepts (matching in order) id, slug, name. Default: empty. Example: <code>[sitekit_menu menu="main-menu"]</code></li>
<li>container – Whether to wrap the ul, and what to wrap it with. Default ‘div’. Example without a container: <code>[sitekit_menu menu="main-menu" container=""]</code></li>
<li>container_class – The class that is applied to the container. Default ‘menu-{menu slug}-container’. Example: <code>[sitekit_menu menu="main-menu" container_class="custom-container"]</code></li>
<li>container_id – The ID that is applied to the container. Default empty.</li>
<li>menu_class – CSS class to use for the ul element which forms the menu. Default ‘menu’. Example: <code>[sitekit_menu menu="main-menu" menu_class="custom-menu"]</code></li>
<li>menu_id – The ID that is applied to the ul element. Default empty.</li>
<li>echo – Whether to echo the menu or return it. Default false.</li>
<li>fallback_cb – If the menu doesn’t exist, a callback function will fire. Default ‘wp_page_menu’.</li>
<li>before – Text before the link markup. Default empty.</li>
<li>after – Text after the link markup. Default empty.</li>
<li>link_before – Text before the link text. Default empty.</li>
<li>link_after – Text after the link text. Default empty.</li>
<li>items_wrap – How the list items should be wrapped. Default <code><ul id="%1$s" class="%2$s">%3$s</ul></code>.</li>
<li>depth – How many levels of the hierarchy are to be included. 0 means all. Default 0. Example: <code>[sitekit_menu menu="primary-menu" depth="2"]</code></li>
<li>walker – Custom walker object to use. Default empty.</li>
</ul>

Sitekit

Widgets: search, archives and categories. Shortcodes: archives, bloginfo, iframe and categories.

Smarter Archives vs Sitekit