EG-Archives Plugin
EG-Archives provides a widget (and a template tag) to display archives in yearly mode, AND monthly, according a specified pivot date.
The standard Archives widget doesn’t accept a lot of parameters. You can just specify
- a title,
- if you want to display posts count or not.
With the EG-Archives widget, you can choose
- the title,
- the format of the list (simple or dropdown list),
- the type: Yearly, Monthly, …
- category, to display archives for only specific categories,
- Number of columns (1 or 2)
A specific type is added: the “mixed Yearly/monthly” type.
With this type, you can display list of archives in yearly mode before a specified year, and in monthly mode after this specified date. This type allows to shorten list, and is very useful if you don’t publish too many posts per year. Example:
- August 2011
- April 2011
- February 2011
- January 2011
- 2010
- 2009
Translations
The plugin comes up with 4 translations. Thanks to the following people for their contributions:
Usage
EG-Archives adds a widget, and a template tag.
Widget
- Go to the Appearence / Widgets menu,
- Active the widget named: EG-Archives,
- Configure it, through the widget menu.
Template tag
You can display the archives list, anywhere in your templates, with the function: <?php eg_get_archives('arguments'); ?>
Arguments are the same than the standard WordPress function wp_get_archives
.
- type (string) The type of archive list to display. Valid values: yearly, monthly, daily, weekly, postbypost. Default is monthly,
- limit (integer) Number of archives to get. Default is no limit,
- format (string) Format for the archive list. Valid values:
- html – In HTML list (
- ) tags and before and after strings. This is the default,
- option – In select () or dropdown option () tags,
- link – Within link () tags,
- custom – Custom list using the before and after strings.
- before (string) Text to place before the link when using the html or custom for format option. There is no default,
- after (string) Text to place after the link when using the html or custom for format option. There is no default,
- show_post_count (boolean) Display number of posts in an archive (1 – true) or do not (0 – false). For use with all type except ‘postbypost’. Defaults to 0,
echo (boolean) Display the output (1 – true) or return it (0 – false). Defaults to 1.
eg_get_archives accept an additional arguments:
pivot (integer) The “pivot” year. Before the pivot, archives are listed i yearly mode, after archives are listed in monthly mode. Default: current year (currently 2009)
- columns (integer) Number of columns to display list. Possible values are 1 or 2. Default is 1.
Licence
This plugin is released under the GPL, you can use it free of charge on your personal or commercial blog.
Translations
The plugin comes with French and English translations, please refer to the WordPress Codex for more information about activating the translation. If you want to help to translate the plugin to your language, please have a look at the eg_series.pot file which contains all defintions and may be used with a gettext editor like Poedit (Windows).
Installation
- The plugin is available for download on the WordPress repository,
- Download the file
eg-archives.zip
, and uncompress it, - Upload the resulting files to a folder in
../wp-content/plugins/
, - Activate EG-Archives through the ‘Plugins’ menu in WordPress,
- The plugin is ready to be used,
You can also install the plugin directly from the WordPress interface.
One the installation is done, you can go to the menu Options / EG-Archives, to setup the options.
Screenshots
Widget configuration page
Archives list
FAQ
Changelog
Version 2.0.2 – Oct 26th, 2011
- Change: internal libraries
Version 2.0.0 – Sept 16th, 2011
- Update the plugin for full WordPress 3.2.x compatibility,
- New: display list in 1 or 2 columns,
- New: ability to load plugin’s stylesheet, or to use your own stylesheet,
- New: ability to disable the default WordPress’ Archive widget,
- Change: widget library is using WordPress 2.8 API now.
Version 1.1.1 – Sept 21st, 2009
- New: Deutsch translation (thanks to Franck Hempel)
Version 1.1.0 – Aug 11th, 2009
- New: Allow multi-widget
- New: WP 2.8 compliant
- New: Translation into Russian (thanks to Fatcow)
Version 1.0.1 – June 10th, 2009
- Bug fix:
- Wrong count of posts,
- Limit parameter doesn’t work,
Version 1.0.0 – June 7th, 2009