Archive-Pro-Matic – Advanced Monthly Sub Archives

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:

  • class – classname for the archive element
  • li_class – classname for a LI element
  • sub_ul_class – classname for a sub ul element
  • sub_li_class – classname for a sub LI element
  • empty_class – classname for an empty LI element

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:

  • 2020
  • 2018
  • 2017
  • 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:

    • 2020
    • January
    • February
    • Mar
    • April
    • May
    • June
    • July
    • Aug
    • September
    • October
    • November
    • December
    • 2018
    • Jan
    • February
    • March
    • April
    • May
    • June
    • Jul
    • Aug
    • September
    • October
    • November
    • December
    • 2013
    • Jan
    • February
    • March
    • Apr
    • May
    • June
    • July
    • August
    • September
    • October
    • Nov
    • December
    • 2012
    • January
    • February
    • March
    • April
    • May
    • June
    • July
    • August
    • Sep
    • October
    • November
    • Dec

    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'"/]
    • 2020
    • January
    • February
    • Mar
    • April
    • May
    • June
    • July
    • Aug
    • September
    • October
    • November
    • December
    • 2018
    • Jan
    • February
    • March
    • April
    • May
    • June
    • Jul
    • Aug
    • September
    • October
    • November
    • December
    • 2013
    • Jan
    • February
    • March
    • Apr
    • May
    • June
    • July
    • August
    • September
    • October
    • Nov
    • December
    • 2012
    • January
    • February
    • March
    • April
    • May
    • June
    • July
    • August
    • Sep
    • October
    • November
    • Dec

    Archive-Pro-Matic – Quarterly and Seasonal Archives


    Notice: Undefined variable: url in /var/www/vhosts/spacedonkey.de/httpdocs/wp-content/plugins/archive-pro-matic/archive-pro-matic.php on line 618

    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:

    Quarterly Archives

    Example of the new quarterly archive type:

    [archives type="quarterly" limit="10" /]

    Seasonal Archives

    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:

    Season names and dates are easily defined. Only the month and day is used, the year is ignored.

    Simple example of seasonal archives:

    [archives type="seasonally" limit="10" /]

    New Attribute: sub_options

    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:

    New Attribute: sep

    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" /]

    Archive-Pro-Matic Category Test


    Notice: Undefined variable: url in /var/www/vhosts/spacedonkey.de/httpdocs/wp-content/plugins/archive-pro-matic/archive-pro-matic.php on line 618

    This is a test for displaying archive-pro-matic category archives.

    Single Category

    [archives type="monthly" cat="collapse-pro-matic" /]

    But what about taxonomies, post tags for example? We can get a monthly archive for a specific post tag like so:

    [archives type="monthly" term="manhole" taxonomy="post_tag" /]

    Or all post tags by month. The following will list only posts that have at least one post tag assigned, grouped by month:

    [archives type="monthly" taxonomy="post_tag" /]

    And as a drop-down list:

    [archives type="monthly" taxonomy="post_tag" sep=" > " format="option" /]

    Special request: Years and each year’s tags as a subsets in a select drop-down:

    [archives type="yearly" taxonomy="post_tag" sep="—" format="option" sub_options="true"/]

    New “Quarterly” type:

    [archives type="quarterly" /]
    [archives type="quarterly" format="option" sep=" - " sub_options="true" /]

    Nes Archive Type “Seasonally”:

    [archives type="seasonally" /]
    [archives type="seasonally" format="option" sep=" - " sub_options="true" /]

    Archive-Pro-Matic Display Multiple Categories

    As of version 1.1.2, multiple categories can be selected using the cat_id attribute. Simply provide a comma separated string of the category ID’s to include. Use a negative ID to omit multiple categories.

    For example to include a yearly archive of posts with both the categories of ‘Archive-Pro-Matic’ (ID 55) and ‘collapse-pro-matic’ (ID 43) the shortcode would be:

    [archives type="yearly" cat_id="55,43"/]
    [archives type="monthly" cat_id="55,43" limit="10" /]

    Archive Pro Matic Highlight Class

    Introducing a new attribute for Archive-Pro-Matic: highlight
    Highlight accepts the following values:

    • current-year
    • active-year

    Assigning ‘current-year’ as the value of the highlight attribute will add a current-year class to the current year in the archive list. Assigning ‘active-year’ would only be assigned to the archive list when placed on an archive page.

    Demos

    We have added a bit of css to highlight each of the classes:

     .current-year {
        border-left: 2px solid red;
     }
    
    .active-year {
         border-left: 2px solid blue;
     }

    current-year

    Assigning ‘current-year’ as the value of the highlight attribute will add a current-year class to the current year in the list:

    [archives type="yearly" cat_id="4" limit="5" highlight="current-year"/]

    active-year

    Assigning ‘active-year’ would only be used on the archive page itself. To see this in action, first visit the an archive page, say 2014 and on that page place an archive list using the sidebar widget or following shortcode.

    [archives type="yearly" cat_id="4" limit="5" highlight="active-year"/]

    Format: Option

    Of course this also needs to work with drop downs.

    [archives type="yearly" format="option" highlight="active-year"/]

    Annual Archive / Archive-Pro-Matic Shortcode Test

    Here are a few tests of the archive pro matic shortcode:

    [archives type="daily" limit="5"]
    [archives type="weekly" limit="5"]
    [archives type="monthly" limit="5"]
    [archives type="yearly" limit="5"]
    [archives type="yearly" limit="5" show_post_count="true"]
    [archives type="decade"]

    Archive-Pro-Matic

    The post_type and cat_id attributes are available by upgrading to Archive-Pro-Matic

    [archives type="yearly" post_type="monkey" limit="5"]
    [archives type="yearly" post_type="monkey" limit="5"]
    [archives type="yearly" cat_id="4" limit="5"]