From 4444d3239e34696cc95506b1521762ae41fa3b3e Mon Sep 17 00:00:00 2001 From: Chaz Larson Date: Tue, 5 Sep 2023 10:11:09 -0500 Subject: [PATCH 1/3] Call out what the placeholders are for. --- docs/defaults/separators.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/defaults/separators.md b/docs/defaults/separators.md index d61544e8..824322b6 100644 --- a/docs/defaults/separators.md +++ b/docs/defaults/separators.md @@ -8,6 +8,10 @@ Below is an example of a separator, which can be seen surrounded by a red square ![](images/separators.jpg) +## Important Note: + +Plex does not support creating these empty collections natively through its UI, so they can behave strangely in some cases, primarily related to showing/hiding them in the main library view. As a workaround, you can use a template variable [`placeholder_SOMETHING_id`] to specify a single movie/show to add to these collections so they have one thing in them and will then behave as expected. + ## Separator Files These are all the files that contain a separator From 9fd523d463d4058d5a8c3084f9a9b67bbc892cf6 Mon Sep 17 00:00:00 2001 From: Chaz Larson Date: Tue, 5 Sep 2023 10:29:54 -0500 Subject: [PATCH 2/3] Link to table of variables --- docs/defaults/separators.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/defaults/separators.md b/docs/defaults/separators.md index 824322b6..b446c62f 100644 --- a/docs/defaults/separators.md +++ b/docs/defaults/separators.md @@ -10,7 +10,7 @@ Below is an example of a separator, which can be seen surrounded by a red square ## Important Note: -Plex does not support creating these empty collections natively through its UI, so they can behave strangely in some cases, primarily related to showing/hiding them in the main library view. As a workaround, you can use a template variable [`placeholder_SOMETHING_id`] to specify a single movie/show to add to these collections so they have one thing in them and will then behave as expected. +Plex does not support creating these empty collections natively through its UI, so they can behave strangely in some cases, primarily related to showing/hiding them in the main library view. As a workaround, you can use a `placeholder_` [template variable](#shared-separator-variables) to specify a single movie/show to add to these collections so they have one thing in them and will then behave as expected. ## Separator Files From ec4285267b7c20f9837972e9af5b52ad956618fb Mon Sep 17 00:00:00 2001 From: Chaz Larson Date: Tue, 5 Sep 2023 10:33:58 -0500 Subject: [PATCH 3/3] More words. --- docs/defaults/separators.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/defaults/separators.md b/docs/defaults/separators.md index b446c62f..ae2d0279 100644 --- a/docs/defaults/separators.md +++ b/docs/defaults/separators.md @@ -10,7 +10,7 @@ Below is an example of a separator, which can be seen surrounded by a red square ## Important Note: -Plex does not support creating these empty collections natively through its UI, so they can behave strangely in some cases, primarily related to showing/hiding them in the main library view. As a workaround, you can use a `placeholder_` [template variable](#shared-separator-variables) to specify a single movie/show to add to these collections so they have one thing in them and will then behave as expected. +Plex does not support creating these empty collections natively through its UI, so they can behave strangely in some cases, primarily related to showing/hiding them in the main library view. As a workaround, you can use a `placeholder_` [template variable](#shared-separator-variables) to specify a single movie/show to add to these collections so they have one thing in them and will then behave as expected. For example, `placeholder_imdb_id: tt0068646` will place The Godfather inside the separator in a movie library. ## Separator Files @@ -50,12 +50,12 @@ Note that the `template_variables:` section only needs to be used if you do want | Variable | Description & Values | |:-------------------------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `use_separator` | **Description:** Turn the [Separator Collection](#use-separators) off.
**Values:** `false` to turn of the collection | -| `sep_style` | **Description:** Choose the [Separator Style](#separator-styles).
**Default:** `orig`
**Values:** `amethyst`, `aqua`, `blue`, `forest`, `fuchsia`, `gold`, `gray`, `green`, `navy`, `ocean`, `olive`, `orchid`, `orig`, `pink`, `plum`, `purple`, `red`, `rust`, `salmon`, `sand`, `stb`, or `tan` | +| `sep_style` | **Description:** Choose the [Separator Style](#separator-styles).
**Default:** `orig`
**Values:** `amethyst`, `aqua`, `blue`, `forest`, `fuchsia`, `gold`, `gray`, `green`, `navy`, `ocean`, `olive`, `orchid`, `orig`, `pink`, `plum`, `purple`, `red`, `rust`, `salmon`, `sand`, `stb`, or `tan` | | `sort_prefix` | **Description:** Changes the prefix of the sort title.
**Default:** `!`
**Values:** Any String | | `sort_title` | **Description:** Changes the sort title of all collections.
**Default:** `<><>_!<>`<br>**Values:** Any String | -| `placeholder_tmdb_movie` | **Description:** Add a placeholder Movie to the Separator.<br>**Values:** TMDb Movie ID | -| `placeholder_tvdb_show` | **Description:** Add a placeholder Show to the Separator.<br>**Values:** TVDb Show ID | -| `placeholder_imdb_id` | **Description:** Add a placeholder Movie/Show to the Separator.<br>**Values:** IMDb ID | +| `placeholder_tmdb_movie` | **Description:** Add a placeholder Movie to the Separator. Only valid for Movie libraries.<br>**Values:** TMDb Movie ID | +| `placeholder_tvdb_show` | **Description:** Add a placeholder Show to the Separator. Only valid for Show libraries.<br>**Values:** TVDb Show ID | +| `placeholder_imdb_id` | **Description:** Add a placeholder Movie/Show to the Separator. Valid for Movie or Show libraries assuming the ID points to an item of the correct type.<br>**Values:** IMDb ID | | `name_separator` | **Description:** Changes the name of the specified key's collection.<br>**Values:** New Collection Name | | `summary_separator` | **Description:** Changes the summary of the specified key's collection.<br>**Values:** New Collection Summary | | `collection_section` | **Description:** Changes the sort order of the collection sections against other default collection sections.<br>**Values:** Any number |