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.

deckerweb

David Decker

<blockquote>
<h4>New Flexibility plus Enhanced User Experience</h4>
<p>Take control over <strong>Your Archive Pages</strong> in <em>Genesis</em> again! Use the ever popular way of <em>Widgets</em> to build your own archive listing or sitemap-like content. Use up to three columns that are responsive and enable automatically. Don’t lose your archive/sitemap creations if you ever switch the <em>Genesis</em> child theme.</p>
<p>A great helper tool for <em>Genesis Child Themes</em>!</p>
</blockquote>
<p><strong>Please note:</strong> The plugin requires the <em>Genesis Theme Framework</em> (GPL-2.0+), a paid premium product released by StudioPress/ Copyblogger Media LLC (via studiopress.com).</p>
<p>Plus: A premium <em>PRO Version</em> of this plugin will be released in the future…! 🙂</p>
<h4>Advantages & Benefits</h4>
<ul>
<li>Avoids long pages & blog posts listings that seem to happen a lot with the default template…</li>
<li>Far more possibilities for your archive pages: different listings of site menus, various site content, authors – plus search form, images etc.</li>
<li>Make sitemap-like pages very easily – use widgets by WordPress, Genesis or third-party plugins</li>
<li>Easily customizeable for any webmaster!</li>
<li>Works across all Genesis child themes – so you can switch your “skin” but not loosing this tool 🙂</li>
<li>Support Genesis 2.0+ and HTML5 enabled child themes!</li>
<li>Ideal for multilingual websites (for example with “WPML”): Much better handling of archive-/ sitemap-like pages for different languages. — <a href="https://wordpress.org/plugins/genesis-widgetized-archive/faq/" rel="ugc">See bottom of FAQ section here</a> for more info on that.</li>
</ul>
<h4>General Features</h4>
<ul>
<li>Small & lightweight plugin tool: Just activate plugin, place your widgets and you’re done!</li>
<li>Adds up to three new widget areas (Sidebars) for the “Archive Page Template”</li>
<li>Adds very few CSS styles for the content area to properly divide widgets with some more space (all other styling is recommended via your child theme) and to enable responsive content columns (if more than one widget area is active)</li>
<li>Customizeable via 2 action hooks: if ever needed you can add content before and after the widgetized section</li>
<li>Customizeable via 6 filters: if ever needed you can customize the widget titles and descriptions</li>
<li>Fully internationalized! Real-life tested and developed with international users in mind!</li>
<li>Fully WPML compatible!</li>
<li>Fully Multisite compatible, you can also network-enable it if ever needed (per site use is recommended).</li>
<li>Tested with WordPress versions 3.4 branch and new 3.5 branch – also in debug mode (no stuff there, ok? 🙂</li>
</ul>
<p>Please note: The plugin requires the Genesis Theme Framework.</p>
<h4>Localization</h4>
<ul>
<li>English (default) – always included</li>
<li>German (de_DE) – always included</li>
<li>.pot file (<code>genesis-widgetized-archive.pot</code>) for translators is also always included 🙂</li>
<li>Easy plugin translation platform with GlotPress tool: <a href="http://translate.wpautobahn.com/projects/genesis-plugins-deckerweb/genesis-widgetized-archive" rel="nofollow ugc">Translate “Genesis Widgetized Archive”…</a></li>
<li><em>Your translation? – <a href="http://genesisthemes.de/en/contact/" rel="nofollow ugc">Just send it in</a></em></li>
</ul>
<p><a href="http://genesisthemes.de/en/" rel="nofollow ugc">A plugin from deckerweb.de and GenesisThemes</a></p>
<h4>Feedback</h4>
<ul>
<li>I am open for your suggestions and feedback – Thank you for using or trying out one of my plugins!</li>
<li>Drop me a line <a href="http://twitter.com/deckerweb" rel="nofollow ugc">@deckerweb</a> on Twitter</li>
<li>Follow me on <a href="http://www.facebook.com/deckerweb.service" rel="nofollow ugc">my Facebook page</a></li>
<li>Or follow me on <a href="http://deckerweb.de/gplus" rel="nofollow ugc">+David Decker</a> on Google Plus 😉</li>
</ul>
<h4>More</h4>
<ul>
<li>My other ‘Genesis Widgetized’ plugins: <a href="https://wordpress.org/plugins/genesis-widgetized-notfound/" rel="ugc"><em>“Genesis Widgetized Not Found & 404”</em></a> plus <a href="https://wordpress.org/plugins/genesis-widgetized-footer/" rel="ugc"><em>“Genesis Widgetized Footer”</em></a></li>
<li><a href="http://genesisthemes.de/en/wp-plugins/" rel="nofollow ugc">Also see my other plugins</a> or see <a href="https://profiles.wordpress.org/daveshine/" rel="nofollow ugc">my WordPress.org profile page</a></li>
<li>Tip: <a href="http://genesisfinder.com/" rel="nofollow ugc"><em>GenesisFinder</em> – Find then create. Your Genesis Framework Search Engine.</a></li>
<li>Hey, come & join the <a href="http://ddwb.me/genesiscommunity" rel="nofollow ugc">Genesis Community on Google+ 🙂</a></li>
</ul>
<h3>Plugin Links</h3>
<ul>
<li><a href="http://translate.wpautobahn.com/projects/genesis-plugins-deckerweb/genesis-widgetized-archive" rel="nofollow ugc">Translations (GlotPress)</a></li>
<li><a href="https://wordpress.org/support/plugin/genesis-widgetized-archive" rel="ugc">User support forums</a></li>
<li><a href="https://gist.github.com/4106349" rel="nofollow ugc">Code snippets archive for customizing, GitHub Gist</a></li>
</ul>
<h3>Donate</h3>
<p>Enjoy using <em>Genesis Widgetized Archive</em>? Please consider <a href="https://www.paypal.me/deckerweb" rel="nofollow ugc">making a small donation</a> to support the project’s continued development.</p>
<h3>Translations</h3>
<ul>
<li>English – default, always included</li>
<li>German (de_DE): Deutsch – immer dabei! <a href="http://deckerweb.de/material/sprachdateien/genesis-plugins/#genesis-widgetized-archive" rel="nofollow ugc">Download auch via deckerweb.de</a></li>
<li>For custom and update-secure language files please upload them to <code>/wp-content/languages/genesis-widgetized-archive/</code> (just create this folder) – This enables you to use fully custom translations that won’t be overridden on plugin updates. Also, complete custom English wording is possible with that as well, just use a language file like <code>genesis-widgetized-archive-en_US.mo/.po</code> to achieve that.</li>
</ul>
<p><strong>Easy plugin translation platform with GlotPress tool:</strong> <a href="http://translate.wpautobahn.com/projects/genesis-plugins-deckerweb/genesis-widgetized-archive" rel="nofollow ugc"><strong>Translate “Genesis Widgetized Archive”…</strong></a></p>
<p><em>Note:</em> All my plugins are internationalized/ translateable by default. This is very important for all users worldwide. So please contribute your language to the plugin to make it even more useful. For translating I recommend the awesome <a href="https://wordpress.org/plugins/codestyling-localization/" rel="ugc">“Codestyling Localization” plugin</a> and for validating the <a href="http://www.poedit.net/" rel="nofollow ugc">“Poedit Editor”</a>, which works fine on Windows, Mac and Linux.</p>
<h3>Idea Behind / Philosophy</h3>
<p>I never really enjoyed the bundled “Archive” page template in Genesis. So I always wanted this template/ area a bit more easily customizeable since I first worked with Genesis! Widgets in WordPress are powerful and allow for adding really diverse and custom stuff – all in a very simple and user-friendly way. The approach of this plugin is to bring more power to the webmasters and users and help avoid other “archive” or “sitemaps” plugins and instead use the powerful tools from WordPress and Genesis that are already there. This plugin here works primarily as a ‘helper’ or ‘bridge’ plugin to just do that :).</p>


Genesis Widgetized Archive

Finally, use widgets to maintain & customize your Archive Page Template in Genesis Framework and Child Themes to create archive/sitemap listings.

Smarter Archives vs Genesis Widgetized Archive