A Pluginoven Test Site
[archives type="birthmonth" order="ASC" /]However, this (or any) unordered list can be formatted using css. Here is an example of how to turn the list in to a grid using the CSS columns attribute:
First, we define a UL class that we can later assign:
ul.grid {
list-style: none;
columns: 4;
}Now we just need to assign this class to our list:
[archives type="birthmonth" order="ASC" class="grid" /]As of Archive-Pro-Matic version 1.1.10 we have added two filters two filters for the decade archives list:
apm_decade_archive_title is used to display how the decade appears in the archive list. The default list is YYYY’s, for example:
2010’s
2000’s
apply_filters('apm_decade_archive_list', $text, $decade);This filter can be used to change how the decade list is displayed by adding the following to the function.php file in the child-theme.
add_filter( 'apm_decade_archive_list', 'list_decade_range', 10, 2 );
function list_decade_range($text, $decade){
$text = $decade.' - '.($decade + 9);
return $text;
}apm_decade_archive_title is used to display the title of the decade archive page. The default title is The YYYY’s for example:
The 2000’s
apply_filters('apm_decade_archive_title', $title, $decade);And would be used by adding the following to the child theme’s function.php file:
add_filter( 'apm_decade_archive_title', 'decade_range_title', 10, 2 );
function decade_range_title($title, $decade){
$title .= ' ('.$decade.' - '.($decade + 9).')';
return $title;
}Here is an example shortcode that will list an archive of posts by decade:
[archives type="decade"/]Currently archives only accept one post type like so:
[archives post_type="monkey"/]But what happens if we provide multiple, comma separated post types?
[archives post_type="monkey, donkey"/][archives post_type="monkey, donkey" show_post_count="true"/]this is a test that will show nested collapse elements with a twist: only the first sub element will be shown. once it has been expanded, the next expand element will be displayed… and so on until the all elements visible.
This is a test of two new types of Archive-Pro-Matic archive lists:
Birthday: Show all posts published on the same day of the year
Birth Month: Show all post published on the same month, regardless of year
[archives type="birthmonth" order="ASC" /][archives type="birthday" order="ASC"/][archives type="birthday" order="ASC" sub_options="true" sub_order="ASC"/][archives type="birthday" order="ASC" sub_options="true" sub_order="ASC" show_empty="true"/][archives type="birthday" order="ASC" sub_options="block" sub_order="ASC" show_empty="true" tag="div" sub_ul_class="my_slim_ul" li_class="block_archive_item" empty_class="grey"/]Building on the new block-style archive described in the last post, we now try with categories:
[archives type="monthly" taxonomy="category" sub_options="block" tag="div" sub_ul_class="my_slim_ul" li_class="block_archive_item" limit="10"/][archives type="monthly" taxonomy="category" term="archive-pro-matic" sub_options="block" tag="div" sub_ul_class="my_slim_ul" li_class="block_archive_item" limit="10"/]or use the cat attribute:
[archives type="monthly" cat="special1-posts" sub_options="block" tag="div" sub_ul_class="my_slim_ul" li_class="block_archive_item" limit="10"/]or use the category attribute (alias for cat):
[archives type="monthly" category="special1-posts" sub_options="block" tag="div" sub_ul_class="my_slim_ul" li_class="block_archive_item" limit="10"/]For an archive of multiple categories, the cat_id attribute must be used:
[archives type="monthly" cat_id="55,43" sub_options="block" tag="div" sub_ul_class="my_slim_ul" li_class="block_archive_item" limit="10"/]This is a test to create a category archive in the following format:
Step one: allow the sub_options attribute to work with standard monthly archives.
[archives type="monthly" sub_options="true" limit="10" /]Step two: add new feature to allow sub_options to be sorted ASC (1 – 12) or DESC (default: 12 – 1). New attribute: sub_order
[archives type="monthly" sub_options="true" sub_order="ASC" limit="10" /]
Step three: add the ability show empty months as placeholders. New attribute: show_empty
[archives type="monthly" sub_options="true" show_empty="true" limit="10" /]Step four: allow month date to be formatted: January becomes Jan. New attribute: month_format just use the date_format attribute
[archives type="monthly" sub_options="true" month_format="M" sub_order="ASC" show_empty="true" limit="10" /]Step five: test that this works with category filters. Here we use cat_id to only show archives for category id 55:
[archives type="monthly" cat_id="55" sub_options="true" sub_order="ASC" show_empty="true" limit="10" month_format="M"/]A single category archive can be shown using the category slug with the cat attribute:
[archives type="monthly" cat="collapse-pro-matic" sub_options="true" sub_order="ASC" show_empty="true" month_format="m" limit="10" /]Step six: adjust format so year and months are displayed in a single line. The following attributes have been added to add classnames to the archive elements for styling:
To test this we first need to define some simple classes:
.my_clean_achive {
border: 1px dotted black;
}
.my_sub_achive {
border: 1px dotted red;
}
.red a {
color: red;
font-weight: bold;
}
.green a {
color: green;
}
.grey {
color: #999999;
}Now we just need to assign the classes to the archive elements:
[archives type="monthly" cat="collapse-pro-matic" sub_options="true" sub_order="ASC" show_empty="true" month_format="M" limit="10" class="my_clean_achive" sub_ul_class="my_sub_achive" li_class="red" sub_li_class="green" empty_class="grey"/]Now that we can control the CSS of every element we can finally create a block style archive using the following css:
.block_archive_item {
display:inline;
margin-left: 5px;
white-space: nowrap;
}
.block_archive_item a {
color: red;
}
[archives type="monthly" cat="collapse-pro-matic" sub_options="true" sub_order="ASC" show_empty="true" month_format="M" limit="10" li_class="block_archive_item" empty_class="grey"/]Nearly there:
Now if we do not want the sub_options (months in this case) to be in a separate element (ul) we need a way let the system know: new accepted value ‘block’ for the sub_options attribute: sub_options=”block”.
[archives type="monthly" sub_options="block" limit="10" /]We also no longer need to wrap the entire archive in a UL element, so we use tag=”div”. Finally we need to assign a sub_ul_class to slim down the sub_ul elements:
.my_slim_ul {
margin: 0;
}
[archives type="monthly" cat="collapse-pro-matic" sub_options="block" sub_order="ASC" show_empty="true" date_format="M" limit="10"
tag="div" sub_ul_class="my_slim_ul" li_class="block_archive_item" empty_class="grey"/]The final result:
Done!
Here is a test using the new link_atts attribute:
[archives type="monthly" cat="collapse-pro-matic" sub_options="block" sub_order="ASC" show_empty="true" date_format="M" limit="10"
tag="div" sub_ul_class="my_slim_ul" li_class="block_archive_item" empty_class="grey" link_atts="target='_blank'"/]Here is an example of using the rel attribute. Notice how selecting a member of one group will auto-collapse members of all other groups.
[expand title="Star Wars" rel="fiction" swaptitle="Not Star Trek"]Target Content[/expand]
[expand title="Star Trek" rel="fiction"]Target Content[/expand]
[expand title="Battlestar Galactica" rel="fiction"]Target Content[/expand]
[expand title="Space Race" rel="history"]Target Content[/expand]
[expand title="Ansari X Prize" rel="history"]Target Content[/expand]Here is an example using the togglegroup attribute. Members of multiple togglegroups may be open at the same time.
[expand title="Star Wars" togglegroup="togfiction"]Target Content[/expand]
[expand title="Star Trek" togglegroup="togfiction"]Target Content[/expand]
[expand title="Battlestar Galactica" togglegroup="togfiction"]Target Content[/expand]
[expand title="Space Race" togglegroup="toghistory"]Target Content[/expand]
[expand title="Ansari X Prize" togglegroup="toghistory"]Target Content[/expand]Here is an example using the rel attribute with highlander grouping:
[expand title="Star Wars" rel="fiction-highlander" swaptitle="Not Star Trek"]Target Content[/expand]
[expand title="Star Trek" rel="fiction-highlander"]Target Content[/expand]
[expand title="Battlestar Galactica" rel="fiction-highlander"]Target Content[/expand]
[expand title="Space Race" rel="history-highlander"]Target Content[/expand]
[expand title="Ansari X Prize" rel="history-highlander"]Target Content[/expand][expand title="Monkeys" togglegroup="animal-highlander"]Target Content[/expand]
[expand title="Donkeys" togglegroup="animal-highlander"]Target Content[/expand]
[expand title="Tigers" togglegroup="animal-highlander"]Target Content[/expand]
[expand title="Bears" togglegroup="animal-highlander"]Target Content[/expand]
[expand title="Porsche" togglegroup="car-highlander"]Target Content[/expand]
[expand title="Volvo" togglegroup="car-highlander"]Target Content[/expand]
[expand title="Mercedes" togglegroup="car-highlander"]Target Content[/expand]This is a test of the group attribute which is being considered to replace rel, will be used as an alias for now:
[expand title="Star Wars" group="gfic" swaptitle="Not Star Trek"]Target Content[/expand]
[expand title="Star Trek" group="gfic"]Target Content[/expand]
[expand title="Battlestar Galactica" group="gfic"]Target Content[/expand]
[expand title="Space Race" group="ghis"]Target Content[/expand]
[expand title="Ansari X Prize" group="ghis"]Target Content[/expand]Quick test to make to see if our ‘number’ issue has been fixed:
[expand title="123" rel="123"]this is a number group[/expand]
[expand title="456" rel="456"]this is also a number group[/expand]Archive-Pro-Matic has two new archive types (Quarterly and Seasonally) and a couple new advanced shortcode attributes to manage seperators (sep) and sub options as described below:
Example of the new quarterly archive type:
[archives type="quarterly" limit="10" /]Seasonal archives are a bit more complex. First the plugin is currently limited to only four (4) seasons per year. The season names and starting dates can be defined in the plugin options as shown in the following screanshot:
Simple example of seasonal archives:
[archives type="seasonally" limit="10" /]Setting sub_options to ‘true’ for quarterly or seasonally archive types will present the year with the quarterly or seasonal archives below like so:
[archives type="seasonally" sub_options="true" limit="10" /]Of course this also works in a drop-down select element:
[archives type="seasonally" format="option" sub_options="true" limit="10" /]However, when setting format=”option” the sub_options could use a little separation. Therefore we have created a new sep attribute:
Same example as above, this time with some fancy sub_option separation, and highlight current season if on archive page:
[archives type="seasonally" format="option" sub_options="true" sep="— " highlight="active-season" limit="20" /]This is a demo of how to use a cookie to auto-collapse a expand element that is expanded by default. The idea is to set up an expand element this is expanded by default, but if a user collapses it once, it will no longer load auto-expanded for that user until the cookie expires.
For example the following expand element should be auto-expanded until it is manually collapsed. After this, the element will remain collapsed when the page is revisited.
[expand title="test" expanded="once" cookiename="my_cookie"]hidden content[/expand]