{"result":{"depiction_url":null,"edges":{"hasreference":{"objects":[{"created":"2026-10-07T11:13:40Z","object_id":{"id":1638,"is_a":["text","documentation","developerguide"],"name":"doc_developerguide_search","title":{"_type":"trans","tr":{"en":"Search"}},"uri":"https:\/\/zotonic.com\/id\/1638"},"seq":1},{"created":"2026-10-07T11:13:40Z","object_id":{"id":1536,"is_a":["text","documentation","developerguide"],"name":"doc_developerguide_access_control","title":{"_type":"trans","tr":{"en":"Keep permission checks at the boundary"}},"uri":"https:\/\/zotonic.com\/id\/1536"},"seq":2}],"predicate":{"id":2774,"is_a":["meta","predicate"],"name":"hasreference","title":{"_type":"trans","tr":{"en":"Documentation reference"}},"uri":"https:\/\/zotonic.com\/id\/hasreference"}},"references":{"objects":[{"created":"2020-05-30T05:48:17Z","object_id":{"id":1982,"is_a":["text","documentation","reference","notification"],"name":"doc_notification_search_query","title":"observe_search_query\/2","uri":"https:\/\/zotonic.com\/id\/1982"},"seq":1000000}],"predicate":{"id":332,"is_a":["meta","predicate"],"name":"references","title":{"_type":"trans","tr":{"en":"References"}},"uri":"https:\/\/zotonic.com\/id\/references"}},"subject":{"objects":[{"created":"2026-10-07T11:13:40Z","object_id":{"id":2557,"is_a":["categorization","keyword","keyword_information_type"],"name":"zotonic_topic_cookbook_recipe","title":"Cookbook recipe","uri":"https:\/\/zotonic.com\/id\/2557"},"seq":1},{"created":"2026-10-07T11:13:40Z","object_id":{"id":2564,"is_a":["categorization","keyword","keyword_audience"],"name":"zotonic_topic_backend_developer","title":"Backend developer","uri":"https:\/\/zotonic.com\/id\/2564"},"seq":2},{"created":"2026-10-07T11:13:40Z","object_id":{"id":2586,"is_a":["categorization","keyword","keyword_domain"],"name":"zotonic_topic_search_and_discovery","title":"Search and discovery","uri":"https:\/\/zotonic.com\/id\/2586"},"seq":3},{"created":"2026-10-07T11:13:40Z","object_id":{"id":2627,"is_a":["categorization","keyword","keyword_architecture"],"name":"zotonic_topic_notification","title":"Notification","uri":"https:\/\/zotonic.com\/id\/2627"},"seq":4},{"created":"2026-10-07T11:13:40Z","object_id":{"id":2643,"is_a":["categorization","keyword","keyword_task"],"name":"zotonic_topic_query","title":"Query","uri":"https:\/\/zotonic.com\/id\/2643"},"seq":5}],"predicate":{"id":308,"is_a":["meta","predicate"],"name":"subject","title":{"_type":"trans","tr":{"en":"Keyword"}},"uri":"http:\/\/purl.org\/dc\/elements\/1.1\/subject"}}},"id":1575,"is_a":["text","documentation","cookbook"],"links":[{"rel":"self","target":"https:\/\/zotonic.com\/.zotonic\/websub\/topic\/1575"},{"rel":"hub","target":"https:\/\/zotonic.com\/.zotonic\/websub"}],"medium":null,"medium_url":null,"name":"doc_cookbook_custom_search","page_url":{"en":"https:\/\/zotonic.com\/cookbook\/1575\/add-a-named-resource-search","x-default":"https:\/\/zotonic.com\/cookbook\/1575\/add-a-named-resource-search"},"preview_url":null,"resource":{"body":{"_type":"trans","tr":{"en":"<p>First try a query resource or the built-in query search. For a new named search, add this callback to the active <code>mod_garden<\/code> module:<\/p>\n<pre class=\"notranslate\"><code class=\"notranslate language-erlang\">-include_lib(&quot;zotonic_core\/include\/zotonic.hrl&quot;).\n-export([observe_search_query\/2]).\n\nobserve_search_query(#search_query{name = &lt;&lt;&quot;garden_featured&quot;&gt;&gt;}, _Context) -&gt;\n    #search_sql{\n        select = &quot;r.id&quot;,\n        from = &quot;rsc r&quot;,\n        where = &quot;r.is_featured = $1&quot;,\n        args = [true],\n        order = &quot;r.pivot_title, r.id&quot;,\n        tables = [{rsc, &quot;r&quot;}]\n    };\nobserve_search_query(_Query, _Context) -&gt;\n    undefined.\n<\/code><\/pre>\n<p>Merge the include and export into the existing module; do not duplicate its module declaration. Compile and refresh observer registration. Mark a practice resource as featured, then render:<\/p>\n<pre class=\"notranslate\"><code class=\"notranslate language-django\">{% for result_id in m.search.garden_featured %}\n    &lt;p&gt;&lt;a href=&quot;{{ result_id.page_url }}&quot;&gt;{{ result_id.title }}&lt;\/a&gt;&lt;\/p&gt;\n{% empty %}\n    &lt;p&gt;No featured pages are visible.&lt;\/p&gt;\n{% endfor %}\n<\/code><\/pre>\n<p>Declaring the <code>rsc<\/code> table alias allows the search engine to add its normal visibility constraints. Test as a visitor and as an editor, including an unpublished or restricted resource. Use SQL parameters for values and fixed, reviewed SQL for identifiers. A search of unrelated custom tables does not automatically gain resource ACL checks.<\/p>"}},"category_id":{"id":318,"is_a":["meta","category"],"name":"cookbook","title":{"_type":"trans","tr":{"en":"Cookbook"}},"uri":"https:\/\/test.zotonic.com\/id\/318"},"content_group_id":{"id":339,"is_a":["meta","content_group"],"name":"default_content_group","title":{"_type":"trans","tr":{"en":"Default Content Group"}},"uri":"https:\/\/zotonic.com\/id\/default_content_group"},"created":"2020-05-30T05:47:26Z","creator_id":{"id":336,"is_a":["person","robot"],"name":"gitbot","title":"Git","uri":"https:\/\/zotonic.com\/id\/336"},"doc_editorial_bundle":true,"doc_editorial_edges":{"hasreference":[1536,1638],"subject":[2557,2564,2586,2627,2643]},"github_url":"https:\/\/github.com\/zotonic\/zotonic\/tree\/master\/doc\/cookbook\/custom-search.rst","is_authoritative":true,"is_dependent":false,"is_featured":false,"is_protected":false,"is_published":true,"is_unfindable":false,"language":["en"],"modified":"2026-10-07T11:13:49Z","modifier_id":{"id":1,"is_a":["person"],"name":"administrator","title":"Site Administrator","uri":"https:\/\/zotonic.com\/id\/1"},"name":"doc_cookbook_custom_search","pivot_geocode":null,"pivot_location_lat":null,"pivot_location_lng":null,"privacy":0,"publication_end":"9999-06-01T00:00:00Z","publication_start":"2022-02-15T10:01:29Z","slug":"add-a-named-resource-search","summary":{"_type":"trans","tr":{"en":"Use a current search notification and let Zotonic apply resource visibility."}},"title":{"_type":"trans","tr":{"en":"Add a named resource search"}},"title_slug":{"_type":"trans","tr":{"en":"add-a-named-resource-search"}},"tz":"UTC","uri":null,"version":35,"visible_for":0},"uri":"https:\/\/zotonic.com\/id\/1575","uri_template":"https:\/\/zotonic.com\/id\/:id","websub":{"hub":"https:\/\/zotonic.com\/.zotonic\/websub","topic":"https:\/\/zotonic.com\/.zotonic\/websub\/topic\/1575"}},"status":"ok"}