Skip to content

Paged Widgets

drinfernoo edited this page Aug 5, 2021 · 2 revisions

Paged Widgets

For any AutoWidget where the source path has multiple pages, and they're navigated by choosing an item named "Next", "Next Page", or something similar, AutoWidget offers "Paged Widgets", where selected the "Next Page" item at the end of the widget will update the widget's content with the next page's content instead.

Requirements

  1. The path you're adding to AutoWidget must have a "Next Page" item at the end.
  2. Some add-ons (like TheMovieDb Helper) need a setting like "Next page items on widgets" to be enabled (or disabled, if the setting is to hide them) in order for them to add the "Next Page" item at the end of their lists.
  3. The item limit for the widget must be high enough to show all the items in the path, including the "Next Page" item at the end (usually at least 25 items).

Note: If you need to change an add-on setting (as per #2) to get the "Next Page" item to show for your add-on of choice, and you've already had an AutoWidget pointed there, that isn't showing that item already, you probably just need to clear the cache for that widget. You can do this by opening the context menu on any item in the widget, and choosing "Clear Cache".

Settings

There are a couple settings AutoWidget offers to customize the behavior and visibility of "Next Page" items:

General -> Show 'Next Page' Items

This setting has three options: Never, Always, or Not on Merged Widgets. By default, this is set to Not on Merged Widgets, in order to not confuse the "Next Page" items of multiple paths. If set to Always, "Next Page" items will be shown on every AutoWidget, including merged widgets, which will include them at the end of each path. This looks something like the following:

  • Path 1 - Item 1
  • Path 1 - Item 2
  • Path 1 - Item 3
  • Path 1 - Item ...
  • Path 1 - Next Page
  • Path 2 - Item 1
  • Path 2 - Item 2
  • Path 2 - Item 3
  • Path 2 - Item ...
  • Path 2 - Next Page

The only time this will differ is if the widget is sorted by another method besides the default (like random, for example), wherein the "Next Page" items will be sorted to the end of the widget, in order respective of their order in the group they are defined in, like:

  • Path 1 - Item 1
  • Path 1 - Item 2
  • Path 1 - Item 3
  • Path 1 - Item ...
  • Path 2 - Item 1
  • Path 2 - Item 2
  • Path 2 - Item 3
  • Path 2 - Item ...
  • Path 1 - Next Page
  • Path 2 - Next Page

Changing this to Never effectively disables the feature entirely, by never showing the "Next Page" items.

General -> Use Paged Widgets (Doesn't Affect Merged Widgets)

This setting affects whether or not the "Next Page" items perform the "Paged Widget" behavior, or simply open into a new window. If this setting is enabled (as it is by default), then "Next Page" items will update their widget with a new page of items. Otherwise, they will simply open a window showing the new items. This window will be opened directly to the source path, and will no longer be controlled by AutoWidget, so further navigation is not affected by any of AutoWidget's settings or behaviors. This setting does not affect merged widgets (as disclaimed), leaving "Next Page" items on a merged widget (when shown, as per the previously described setting) to always open a new window, again so as not to confuse the "Next Page" items of multiple paths.