+ {{_('Custom properties are library-specific metadata fields backed by Calibre custom columns. Use them for metadata such as participants, location, or production notes.')}} + {% if current_user.role_admin() %} + {{_('Manage property definitions')}}. + {% endif %} +
+{{_('No custom properties are defined for this library yet.')}}
{% endif %}| {{_('Name')}} | +{{_('Label')}} | +{{_('Type')}} | +{{_('Multiple')}} | +{{_('Visible in Calibre-Web')}} | +
|---|---|---|---|---|
| {{ column.name }} | +#{{ column.label }} | +{{ column.datatype }} | +{% if column.is_multiple %}{{_('Yes')}}{% else %}{{_('No')}}{% endif %} | +{% if column.supported_in_cw %}{{_('Yes')}}{% else %}{{_('No')}}{% endif %} | +
{{_('No custom properties are defined yet.')}}
+ {% endif %} + +{{_('New properties become available in edit metadata, content details, and advanced search after they are created.')}}
+ ++ {{_('Search library-specific metadata such as participants, location, or other custom properties defined for this library.')}} + {% if current_user.role_admin() %} + {{_('Manage property definitions')}}. + {% endif %} +
+{{_('No custom properties are defined for this library yet.')}}
{% endif %} From 6e798395d195e58e0b9eca8dc23bc490c8a46d51 Mon Sep 17 00:00:00 2001 From: Jacob Chapman <7908073+chapmanjacobd@users.noreply.github.com> Date: Wed, 22 Apr 2026 20:39:22 +0000 Subject: [PATCH 2/5] add custom property browsing to sidebar and OPDS navigation --- README.md | 2 +- cps/db.py | 4 ++ cps/opds.py | 92 ++++++++++++++++++++++++++++++++++++- cps/render_template.py | 16 ++++++- cps/templates/feed.xml | 8 ++-- cps/templates/index.xml | 9 ++++ cps/templates/layout.html | 2 +- cps/templates/list.html | 2 +- cps/web.py | 95 +++++++++++++++++++++++++++++++++++++++ 9 files changed, 221 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index d2e93fdbb5..e467aa833b 100755 --- a/README.md +++ b/README.md @@ -111,7 +111,7 @@ Calibre-Web is a web app that offers a clean and intuitive interface for browsin 4. **Configure Calibre Database**: In the admin interface, set the `Location of Calibre database` to the path of the folder containing your Calibre library (where `metadata.db` is located) and click "Save". 5. **Google Drive Integration**: For hosting your Calibre library on Google Drive, refer to the [Google Drive integration guide](https://github.com/janeczku/calibre-web/wiki/G-Drive-Setup#using-google-drive-integration). 6. **Admin Configuration**: Configure your instance via the admin page, referring to the [Basic Configuration](https://github.com/janeczku/calibre-web/wiki/Configuration#basic-configuration) and [UI Configuration](https://github.com/janeczku/calibre-web/wiki/Configuration#ui-configuration) guides. -7. **Custom Properties**: Use **Admin → Manage Custom Properties** to create library-specific fields such as participants, location, or production notes. Those properties appear on the edit metadata page, content details, and advanced search. +7. **Custom Properties**: Use **Admin → Manage Custom Properties** to create library-specific fields such as participants, location, or production notes. Those properties appear on the edit metadata page, content details, advanced search, the browse sidebar, and OPDS navigation. ## Requirements diff --git a/cps/db.py b/cps/db.py index ed000ddc91..c7fbd6c027 100644 --- a/cps/db.py +++ b/cps/db.py @@ -1072,6 +1072,10 @@ def get_cc_columns(self, config, filter_config_custom_read=False): return cc + def get_browseable_cc_columns(self, config): + return [col for col in self.get_cc_columns(config, filter_config_custom_read=True) + if col.normalized and col.datatype in ('text', 'enumeration', 'rating')] + # read search results from calibre-database and return it (function is used for feed and simple search def get_search_results(self, term, config, offset=None, order=None, limit=None, *join): order = order[0] if order else [Books.sort] diff --git a/cps/opds.py b/cps/opds.py index 329a6a0e5b..beb69c6aad 100644 --- a/cps/opds.py +++ b/cps/opds.py @@ -43,11 +43,24 @@ log = logger.create() +def get_browseable_custom_column(column_id): + for column in calibre_db.get_browseable_cc_columns(config): + if column.id == column_id: + return column + return None + + +def format_custom_column_value(column, value): + if column.datatype == 'rating': + return '%.1f' % (value / 2) + return str(value) + + @opds.route("/opds/") @opds.route("/opds") @requires_basic_auth_if_no_ano def feed_index(): - return render_xml_template('index.xml') + return render_xml_template('index.xml', custom_columns=calibre_db.get_browseable_cc_columns(config)) @opds.route("/opds/osd") @@ -245,6 +258,83 @@ def feed_category(book_id): return render_xml_dataset(db.Tags, book_id) +@opds.route("/opds/custom/