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).
FieldsThe 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 FieldsThere 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 OptionsThere 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.