JS Archive List

Descripción

This plugin provides a widget and a filter to display a collapsible archive list in your sidebar or posts using the JS JS library.

Características

  1. Support for Gutenberg blocks. Add it to any FSE theme or Gutenberg compatible theme.
  2. Display a collapsed list of your archives to reduce space.
  3. Uses vanilla JS to add effects and to be compatible with all browsers.
  4. Select your expand/collapse symbol and date format.
  5. Soporte para filtros de archivos.
  6. Auto expands current/select year from posts.
  7. Selecciona las categorías a excluir.
  8. Soporte de múltiples instancias.
  9. Shortcode support [JsArchiveList]
  10. Generates valid HTML code.
  11. Soporta múltiples idiomas.
  12. Compatible with most JS cache and minify plugins.
  13. Y mas por venir…

Configuración

  • Título: el titulo del widget.
  • Símbolo de activación: los caracteres que serán mostrados como viñetas.
  • Effect: Effect to use.
  • Month Format: month’s display format of the month.
  • Expandir: cuando se expande el contenido de la lista.
  • Hide years from before: older years will be hidden under a link. To save space in the page on old sites.
  • Show days inside month list: group posts by day.
  • Mostrar el numero de artículos: muestra cuantos artículos son publicados al año o en en un mes.
  • Show only posts from selected category: show only posts from the selected category when visiting a category page.
  • Expandir/reducir solo al hacer clic sobre el símbolo: seleccione si una animación inicia al hacer clic sobre el enlace o solo la viñeta.
  • Only expand one at the same time: select if you want to have only one expanded at the same time.
  • Mostrar los artículos mensuales: mostrar los títulos de los artículos mensuales.
  • Show post date next to post title: show post’s date next to post title.
  • Sort posts by: select how to sort the posts under months.
  • Include or Exclude categories: Select the categories to include or exclude.

Capturas

  • A list of the archives, archives for each month are hidden under years.
  • A list of archives and its month archives expanded.
  • Block options to configure the list.

Bloques

Este plugin proporciona 1 bloque.

  • JS Archive List A block for displaying an archive list with some effects.

Instalación

  1. Make a directory js-archive-list-widget under /wp-content/plugins/
  2. Sube todos los archivos descargados a /wp-content/plugins/js-archive-list-widget/
  3. Active el plugin en la sección de plugines.
  4. Go to Presentation -> Widgets and drag the JS Archive List to your sidebar and configure it, if you want to display it inside a post then write [JSArchiveList] at the location where it will be shown and save it.

Preguntas frecuentes

Why there are 2 widgets?

Since version 6.0 the widget was migrated to a Gutenberg block. So there will be a Gutenberg block with the most modern code and compatibility and a legacy version that is 100% made in PHP to keep compatibility with older installations.

¿Por qué este plugin no funciona?

By support experience, like 99% of problems are due to:

  • There’s a Javascript error caused by other plugin, and it stops any further code execution, check your browser’s logs to find the problem and deactivate the conflict plugin.
  • Your template doesn’t have a wp_footer() function, this plugin requires this function to load JS code at the end of the website to improve speed.

I’m using custom permalinks, How can I change the links?

Currently, there’s no function in WP API for getting link for date archives when using custom permalinks. So, you’ll need to modify/hack the source code to support your custom link structure, you can do this by changing the lines where I call get_month_link and get_year_link.

How can I exclude some categories from navigation?

This plugin only shows the posts from included/excluded categories. It does not remove them from the navigation. If you want to do it you have to install a 3rd party plugin like Ultimate Category Excluder or Simple Exclude Categories

¿Como puedo enviarle una traducción?

Envíeme el archivo .mo traducido a migueluseche(a)skatox.com e indique el idioma, puedo leer inglés o español, así que por favor escriba en dichos idiomas.

Can I use images as bullets or trigger symbols?

Sí, selecciona «Espacio vacío» como símbolo de activación y guarda. Luego puedes añadir cualquier fondo personalizado usando CSS.
Solo juega con las clases del widget: .jaw_symbol, .jaw_years, .jaw_months.

¿Puedo mostrar esta lista dentro de artículos?

Yes, just add the JS Archive List block or add a shortcode block and write [JsArchiveList] anywhere inside a post
or page’s contest and it will be replaced for the archive list when rendering the content. You can add the following
parameters to change its behavior:

  1. showcount ( boolean ): select if you want to show the count post inside that month/year.
  2. showpost ( boolean ): show post’s titles under months.
  3. expand («none», «never», «expand»): never expand by default, current year only and always expand.
  4. month_format («short», «full», «number»): the format of the date.
  5. ex_sym: el símbolo de expandir.
  6. con_sym: el símbolo de colapsar.
  7. only_sym_link: solo se expande/colapsa al hacer clic sobre la viñeta.
  8. effect («», «slide», «fade»): the JS effect to implement.
  9. excluir: IDs (separados por coma) de las categorías a excluir.
  10. type: ID of the type of the posts to show, this is if you’re using custom type posts. By default will show posts.

Así que por ejemplo:

[JsArchiveList month_format=number showpost=1 showcount=1 ex_sym=+ con_sym=- effect=slide type=page]

Mostrará un widget con meses como números, mostrando las entradas como meses y su cuenta, los símbolos son + y – y el efecto se desvanecerá. Puedes ver el código fuente para más información.

¿Como puedo contribuir con este plugin?

Al utilizarlo, recomendarlo a otros usuarios, dándole una valoración de 5 estrellas en la página del plugin en WordPress, sugiriendo características o programando nuevas características y, finalmente, al DONAR utilizando el enlace de la web del plugin.

¿Cómo puedo añadir múltiples instancias?

Desde la versión 2.0 puedes añadir tantas instancias como quieras, pero hay otra forma de hacerlo, solo añade un nuevo widget de texto solo con los shortcode [JSArchiveList] y luego tendrás una nueva copia del widget.

¿Puedo tener diferentes instancias con diferentes configuraciones?

Desde la versión 2.0 es posible. Cada instancia tiene su propia configuración. Los atajos de escritorio del widget son controlados por los atajos de escritorio de los atributos.

Reseñas

16 de marzo de 2024 1 respuesta
Exactly the plugin in I was looking for – A way to show only one of my posts categories in a drop down collapsible menu! I have tried some other plugins, but none of them gave me the customizable options I was looking for.
31 de julio de 2023 1 respuesta
I was approaching 100 posts over a 5 year period on my blog, and the stock archive widget was getting very long. I was looking for a new plugin that would shrink down the list, and provide expand/contract options for years and months. Alas I find JS Archive List which provided exactly what I was looking for. It offers a smooth and clean look and feel. A slight problem with the title font/size was quickly resolved with the assistance from the developer. Kudos to a terrific plugin and a helpful responsive developer. ⭐️ ⭐️ ⭐️ ⭐️ ⭐️
25 de enero de 2017 1 respuesta
Hello Miguel, Jquery archive list widget is great. You have keep the widget simple but effective. It does what it should. it is difficult to find archive widgets or plugins. It is even more difficult to find archive widgets and plugins that show the archives of blog posts, pages or media. Your widget does this and so much more without making it difficult to use. It is also compatible with other widgets and plugins. Thank you for a fantastic widget. I wish you continued success with this widget and all you do. I hope that will consider maintaining this widget and eventually releasing updates. Best wishes
Leer todas las 45 reseñas

Colaboradores y desarrolladores

«JS Archive List» es un software de código abierto. Las siguientes personas han colaborado con este plugin.

Colaboradores

«JS Archive List» ha sido traducido a 7 idiomas locales. Gracias a los traductores por sus contribuciones.

Traduce «JS Archive List» a tu idioma.

¿Interesado en el desarrollo?

Revisa el código , echa un vistazo al repositorio SVN o suscríbete al registro de desarrollo por RSS.

Registro de cambios

6.1.5

  • Legacy widget: solving include/exclude not working in new WordPress installations.

6.1.4

  • Solving a bug when expand was selected to all and no symbol was set.

6.1.3

  • Legacy widget: solving settings save bug when changing checkboxes.
  • Legacy widget: solving settings load when using the widget mode.
  • Legacy widget: rewriting clicking event function to avoid bugs and issues with certain settings.

6.1.2

  • Solved scrolling bug when clickin day’s link.

6.1.1

  • Solved post’s list bug when using the shortcode.
  • Solved title bug of showing 1 when using the shortcode.
  • Updated translations for spanish and portuguese.

6.1.0

  • Added option to sort month’s posts by id, date or title.
  • Added option to add post’s date to the month’s post list.
  • New option to display posts grouped by day.
  • New option to hide older years in a toggle (good for old sites).
  • Improved frontend code to make it more efficient and slightly faster.
  • Fixed bug of changing the symbol when data was not loaded.
  • Legacy version: added jawl_widget_title hook to allow changing the widget’s title (helpful for translations).

6.0.5

  • Improved Gutenberg block to be more efficient and faster.
  • Changed block’s animation from CSS to JS to increase compatibility.
  • Changed legacy widget’s animation from CSS to JS to increase compatibility.
  • Fixed shortcode name and updated documentation to reflect the change.
  • Fixing shortcode parameters and values to make it work ok.
  • Adding support for accordion option for the Gutenberg block.

6.0.1

  • Code migrated to Gutenberg block. Now you can use this plugin as a Gutenberg block on any modern theme.
  • The block version reads the archive dynamically. It saves bandwidth and reduces old DOM size on old sites.
  • JS code is only loaded if there’s a widget or block is added to page. No more always loading JS and CSS code.
  • Updated CSS code to improve animations on all browsers.
  • Depecrated old php version. It will only be on maintenance mode and new Gutenberg block will be supported.
  • Improved automated tests and code, to make future versions easier to develop.

5.1

  • Fixed ‘missing array key accordion’ bug.

5.0

  • Removed jQuery dependency and rewrote the plugin in full vanilla Javascript.
  • Added compatibility with Gutenberg’s block.
  • Added option to include categories. You can now just select the categories to include.
  • Renamed plugin name, shortcode now it’s [JSArchiveList] but old one is kept for backwards compatibility.
  • Improved caret down symbol when selected.
  • Fixed wrong HTML at settings page (thanks to Cosam_jp for the report).
  • Fixed bad use of selected function at settings page (thanks to Cosam_jp for the report).
  • Solved expansion bug when current post belong to an excluded category.
  • Solved an expansion/collapse problem when activating this option and excluding or including categories.
  • Solved bug when post titles were empty.

4.0.1

  • Better JS file caching: enqueue URL now uses plugin version number when included (instead of WordPress version).
  • Solving CSS typo error introduced in 4.0.0
  • Fixing Data Source instance bug (thanks to imlwebadmin for the fix)
  • Solving incompatibility with Recent Post Widget( thanks to Ramanan for the fix).

4.0.0

  • Title is translated on showing, so the widget title is updated in real-time when a user switches languages on the site. (thanks to @udi86)
  • Added ‘widget_archive’ class to the widget. Many people requested this.
  • Added Ukrainian and Russian translation (thanks to Alex Popov).
  • Added support for ‘Remove Widget Titles’ plugin.
  • Added option to work as an accordion.
  • Changing collapse icon to – so it has the same width as the + sign.
  • Fixed closing wrong
    tag at settings.
  • Fixed double join bug when excluding posts.
  • Formatted code to WordPress standards.
  • Several performance improvements.

3.0.6

  • Fixed some compatibility issues with translations plugins like PolyLang.

3.0.5

  • Fixed Javascript bug present in Internet Explorer 6,7,8,9,10.

3.0.4

  • Shortcut has been changed to [JSArchiveList] because WordPress 4.4 doesn’t let spaces in shortcodes.

3.0.3

  • Minor fixes to add total compatibility with WordPress 4.3

3.0.2

  • Solved missing months bug.

3.0.1

  • Solved month linking bug.
  • Checkbox are easier to click at widget’s configuration, now each text is a label.

3.0

  • Complete rewrite of the javascript code, it has less size, easier to understand and should work faster.
  • Added support for custom posts, now you can create archive widgets for your custom posts.
  • Added active CSS class to indicate when a link points to current URL.
  • Added title attribute to links to generate valid HTML5 code.
  • Added Dutch translation (thanks to Patrick Schreibing).
  • Migrated category selection to WordPress checkbox tool.
  • Solved bugs when excluding categories.
  • Solved bug of missing expanded class on months (thanks to pjarts).
  • Solved not expanding months bug when selecting some options.

2.2

  • Added support for HTTPS, now the plugin generates the correct link if HTTPS is being used, thanks to bridgetwes for the patch.
  • Added more expansion options, you can select if you want to expand: only on current date, current loaded post, both, none or all archives dates.
  • Added an option to show only posts from selected category when visiting a category page.

2.0.1

  • Added option to exclude categories when using shortcodes, just add categories’ ID separated by commas in the exclude attribute.
  • Solved bug of not including JS file when using a filter without any widget.
  • Solved bug of not including JS in some WP installations under Windows.

2.0

  • Huge update thanks to donations! If you upgrade to this version you’ll NEED to configure the widget AGAIN, due to architecture rewriting configuration may get lost.
  • Added support for multiples instances, finally you can have as many widgets as you want without any hack 🙂
  • Added support for dynamic widgets.s
  • Added an option to not have any effect when expanding or collapsing.
  • Added an option to activate the expand/collapse only when clicking the bullet.
  • Removed dynamic generation of the JS file, now you don’t need to write permissions on the folder.
  • Rewrote JS code, now it is a single JS file for all instances, improved performance and compatible with all cache plugins.
  • Updated translation files for Spanish, Czech, Slovak and Italian.

1.4.2

  • Fixed some several bugs, thanks to Marco Lizza who reviewed the code and fixed them. Plugin should be more stable and won’t throw errors when display_errors is on.

1.4.1

  • Solved Javascript bug where in some configurations, months and posts links were not working.

1.4

  • Updated i10n functions to WordPress 3.5, no more deprecations warning should appear with i10n stuff.
  • Solved the i10n bug of not translating exclude categories label.
  • Improved Javascript code (please save again the configuration to take effect)
  • Better shortcode/filter support. now it has attributes for different behavior on instances. (There’s no support for effect and symbol because it is managed through the JS file )

1.3

  • Improved query performance and added option to exclude categories. (thanks to Michael Westergaard for the work)

1.2.3

  • Fixing i18n bug due to new WordPress changes, now it loads your language (if it was translated) correctly.

1.2.2

  • Fixed the bug of wrong year displaying on pages.
  • JS code is not generated dynamically, now it generates in a separated file. For better performance and to support any minify plugins.

1.2.1

  • Improved generated HTML code to be more compatible when JS is off, also helps to search engines to navigate through archives pages.
  • Fixed a bug where in some cases a wrong year expanded at home page.
  • Added Slovak translation

1.2

  • Added option to automatically expand current year or post’s year (thanks to Michael Westergaard for most of the work)
  • Cleaned code and make it more readable for future hacks from developers.

1.1.2

  • Changed plugin’s JS file loading to the footer, so it doesn’t affect your site’s loading speed.
  • Added default value for widget’s title. And it is included in translation files, so this can be used in multi-language sites.
  • Plugin translated to Czech (CZ) thanks to Tomas Valenta.

1.1.1

  • Removed   characters, all spacing should be done by CSS.

1.1

  • Added support for multiples instances (by writing [JSArchiveList] on any Text widget)
  • Added support for WordPress’ reading filters, like reading permissions using Role Scoper plugin (thanks to Ramiro García for the patch)
  • Improved compatibility with WordPress 3.x

1.0

  • Added support for month’s format
  • Now the jquery archive list can be printed from a post, just write [JSArchiveList] anywhere inside the post.
  • Added support for i18n, so you can translate widget configuration’s text to your language.
  • Separated JS code from HTML code, so browsers should cache JS content for faster processing.
  • Carga automática de librerías jQuery JS.
  • Almost all code were rewritten for better maintainer and easy way to add new features.
  • Improved code to be more WordPress compatible.

0.1.3

  • Initial public version.