Name | View Master |
Description | Populate a note with information about other notes in a formatted manner. |
Icon | preview |
Instructions | This plugin will create a view based on data contained in other notes, pulling in images and data from pages tagged with a certain tag grouped by a list of other tags.. This can be used to create a media gallery page, a list of projects, etc. BREAKING CHANGE: Starting in v1.1.0 the list separator for Group By Tags and Include Fields was changed from a comma to an ampersand to allow tag grouping to include multiple tags and allow exclusions. Please adjust your page options accordingly if you have pages generated using <1.1.0.This is done by creating a note with at least the following two rows which define the tag to query on as well as a list of ampersand-separated tags define the groups. For example, to display a wallboard based on TV Shows and group them by watching and backlog tags, create a note with a table containing the following two fields: - Query By : tv-series - Group By Tags : watching&backlog Once the table exists on the note, run the Wallboard plugin from the note menu and it will collect data from the referenced notes and create a section for each Group By Tag under which a view will be created containing information from the note. The image used in the table will be the first image in the referenced note, resized to a certain width (set in order: the width specified on the page, the global app setting, or 125). Fields The data fields pulled into the table are defined on the referenced notes using the inline field syntax from the Dataview plugin for Obsidian. e.g. Field::Value . Right now the plugin pulls in all fields with this syntax, but this will at some point be configurable to only include fields specified using a setting.Computed Fields There is support for computed fields. These fields are denoted with a + as the first character and there is currently one option: +Progress .- +Progress : This will display a progress bar showing the progress on tasks in the referenced note, in 10% increments. The characters will default to ★ and ☆ but there are plugin settings to set them to something else.Page Options There are optional page settings that can be defined in the table as well. Include Fields is a ampersand-separated list of fields that will be included. If it is not there than all fields on the referenced note will be included. For example, this will include only Genre and Service in the view:- Include Fields : Genre&Service Sort By will define a field to use to order the notes. This field must be an integer value and sorting is done in ascending order (so 1 is first).- Sort By : Priority Sort Order will define the order to sort by. The options are either asc or desc and it defaults to asc Display As defines the view to use for the output, currently either gallery for a card view or table for a more traditional table. For gallery, the number of columns created will be, in order, the amount specified on the page, the global app setting, or 3.- Display As : table Show Image can turn off image output; valid values are true or false and it defaults to true.- Show Image : false Page specific settings can also be included here which will override the global setting - Image Width : 200 - Table Columns : 4 An example page options table with some options set. This will query for pages with the foo tag grouping by two different sets, bar and not baz and other. These are the only two required options. For Include Fields only field1 and field2 will be shown with the notes and for Sort By the notes will be in order based on the value of field1. This also overrides the number of columns to be 4 and set the image width to 200. |
Setting | Default image width |
Setting | Default table columns |
Setting | Progress completion character |
Setting | Progress remaining character |
1.0.0
Initial public release
1.0.1
Include webp
in image extensions and made field value regex way less restrictive
1.1.0
Added Sort By
page option to sort notes in a group by a field. NOTE: For now this field must be included in the Include Fields
list.
Group By Tags
can now have multiple tags defined for a single group, using the normal comma separated list that Amplenote supports. Tag groups are now separated by an ampersand (&
) character. This also mean tag exclusions are now supported, so a group with tag foo and not bar would be foo,^bar
Include Fields
is now also separated by an ampersand (&
) character to maintain consistency with Group By Tags
1.1.1
Fix an issue with loading page options when running the plugin multiple times
2.0.0
Added Display As
as an optional page option with two valid values: gallery and table. This control how the notes are output on the page; gallery is the format that has been output previously while table will output in a more traditional table format (but still includes the image if it exists).
gallery is the default value to maintain consistency with previous generated data
2.1.0
Sort By
field no longer needs to be the Include Fields
list
Added support for computed fields, of which Progress is the first one (using +Progress
in the Include Fields
list. This will display a progress bar for tasks on the referenced note. Characters to use for completed and remaining percentage can be set in the settings but will default to a closed and open star, respectively.
Added Show Image
page option to be able to turn off images in view
Fixed an issue when Include Fields
is not set.
Fixed an issue with Display As
not defaulting to gallery
2.2.0
Sort By
now supports alphabetical sorting as well by the {today}
date format.
It will attempt to sort by number, then date, then finally alphabetically.
Add Sort Order
page option that can be either asc
or desc
that determines which direction to sort
2.2.1
Fix issue when Query Tag has multiple tags or negations
2.2.2
Fixed variable name in log message that stopped processing