{"result":{"depiction_url":null,"edges":{"relation":{"objects":[{"created":"2020-05-30T05:48:23Z","object_id":{"id":1331,"is_a":["text","documentation","reference","module"],"name":"doc_module_mod_admin","title":"mod_admin","uri":"https:\/\/zotonic.com\/id\/1331"},"seq":1000000},{"created":"2020-05-30T05:48:23Z","object_id":{"id":1332,"is_a":["text","documentation","reference","template_filter"],"name":"doc_template_filter_filter_menu_rsc","title":"menu_rsc","uri":"https:\/\/zotonic.com\/id\/1332"},"seq":1000000}],"predicate":{"id":303,"is_a":["meta","predicate"],"name":"relation","title":{"_type":"trans","tr":{"nl":"Relatie","en":"Relation"}},"uri":"http:\/\/purl.org\/dc\/terms\/relation"}},"subject":{"objects":[{"created":"2026-09-09T13:47:48Z","object_id":{"id":2555,"is_a":["categorization","keyword","keyword_information_type"],"name":"zotonic_topic_reference","title":"Reference","uri":"https:\/\/zotonic.com\/id\/2555"},"seq":1},{"created":"2026-09-09T13:47:48Z","object_id":{"id":2563,"is_a":["categorization","keyword","keyword_audience"],"name":"zotonic_topic_frontend_developer","title":"Frontend developer","uri":"https:\/\/zotonic.com\/id\/2563"},"seq":2},{"created":"2026-09-09T13:47:48Z","object_id":{"id":2583,"is_a":["categorization","keyword","keyword_domain"],"name":"zotonic_topic_user_interface_and_interaction","title":"User interface and interaction","uri":"https:\/\/zotonic.com\/id\/2583"},"seq":3},{"created":"2026-09-09T13:47:48Z","object_id":{"id":2635,"is_a":["categorization","keyword","keyword_architecture"],"name":"zotonic_topic_module","title":"Module","uri":"https:\/\/zotonic.com\/id\/2635"},"seq":4},{"created":"2026-09-09T13:47:48Z","object_id":{"id":2641,"is_a":["categorization","keyword","keyword_task"],"name":"zotonic_topic_render","title":"Render","uri":"https:\/\/zotonic.com\/id\/2641"},"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":1822,"is_a":["text","documentation","reference","module"],"links":[{"rel":"self","target":"https:\/\/zotonic.com\/.zotonic\/websub\/topic\/1822"},{"rel":"hub","target":"https:\/\/zotonic.com\/.zotonic\/websub"}],"medium":null,"medium_url":null,"name":"doc_module_mod_admin_frontend","page_url":{"en":"https:\/\/zotonic.com\/docs\/1822\/mod_admin_frontend","x-default":"https:\/\/zotonic.com\/docs\/1822\/mod_admin_frontend"},"preview_url":null,"resource":{"version":4001,"pivot_location_lat":null,"title":"mod_admin_frontend","is_authoritative":true,"body":"

Adds editing of resources, menu-trees and collections for non-admin users.<\/p>\n

With many sites it is needed to let “normal” users edit content. For those users the \/admin<\/code> interface is\noverwhelming and also gives too many options that only administrators should be using.<\/p>\n

For this use-case the mod_admin_frontend is created. It reuses some templates and parts of the normal admin, but in\nsuch a way that only the most needed options and fields are present. It also enables editing a menu-tree or collection,\nside-by-side with the content in the menu-tree.<\/p>\n

Interface and dispatching<\/h2>\n

The interface is a one-page interface which uses postbacks to update the currently edited resource and forms. The\nediting history is maintained by using hashes in the url.<\/p>\n

The URL of the edit page is generated by the dispatch rule admin_frontend_edit<\/code>:<\/p>\n

[\n    {admin_frontend_edit, ["edit"], controller_page, [{acl, is_auth}, {template, "page_admin_frontend_edit.tpl"}]},\n    {admin_frontend_edit, ["edit", id], controller_page, [{acl_action, edit}, {template, {cat, "page_admin_frontend_edit.tpl"}}]}\n].\n<\/code><\/pre>\n
The template uses the menu_rsc<\/code> filter to find the contextual menu for the resource being edited. Per default the\nmenu_rsc<\/code> filter will fallback to the resource with the name main_menu<\/code>. Hook into the #menu_rsc{}<\/code> notification to\nchange this behavior.<\/p>\n
To edit a specific resource in the context of a menu that is non-standard for the resource, use the following code:<\/p>\n
<a href="{% url admin_frontend_edit id=my_menu %}#edit_id={{ id }}">Click to edit {{ id.title }}<\/a>\n<\/code><\/pre>\n
Customizing and templates<\/h2>\n
The mod_admin_frontend<\/code> makes heavy use of catinclude<\/code> to find the correct templates.<\/p>\n
The column with the menu is rendered using {% catinclude "_admin_menu_menu_view.tpl" tree_id ... %}<\/code>. The\nresource-column with the main editing form is rendered using {% catinclude "_admin_frontend_edit.tpl" id ... %}<\/code>.\nThis column is loaded lazily via a postback.<\/p>\n
Customizing the menu column<\/h3>\n
Extra content can be added above or below the menu view by overruling the blocks above_menu<\/code> and below_menu<\/code>.<\/p>\n
Customizing the main edit column<\/h3>\n
The main edit template _admin_frontend_edit.tpl<\/code> provides the main edit-form, javascript initializations and fields for\nbasic publication status editing.<\/p>\n
The main edit block edit_blocks<\/code> is defined as follows and can be overruled for specific categories:<\/p>\n
{% block edit_blocks %}\n    {% catinclude "_admin_edit_basics.tpl" id is_editable=is_editable languages=languages %}\n\n    {% if id.category_id.feature_show_address %}\n        {% catinclude "_admin_edit_content_address.tpl" id is_editable=is_editable languages=languages %}\n    {% endif %}\n\n    {% all catinclude "_admin_edit_content.tpl" id is_editable=is_editable languages=languages %}\n\n    {% if id.is_a.media or id.medium %}\n        {% include "_admin_edit_content_media.tpl" %}\n    {% endif %}\n\n    {% catinclude "_admin_edit_body.tpl" id is_editable=is_editable languages=languages %}\n    {% catinclude "_admin_edit_blocks.tpl" id is_editable=is_editable languages=languages %}\n    {% catinclude "_admin_edit_depiction.tpl" id is_editable=is_editable languages=languages %}\n{% endblock %}\n<\/code><\/pre>\n
If any content needs to be added on top of the page, between the publication checkbox and the main edit fields, then\noverrule the block meta_data_after<\/code>.<\/p>\n
If you click on the cog icon on the right, then a meta data panel is shown (for access-control options and language\nsettings). This panel can be extended with extra tabs using the blocks meta_tabs<\/code> and meta_panels<\/code>.<\/p>\n
Accepted Events<\/h2>\n
Delegate callbacks:<\/p>\n
  • event\/2<\/code> with postback<\/code> messages: admin_menu_edit<\/code>.<\/li>
  • event\/2<\/code> with postback_notify<\/code> messages: <<"admin-menu-edit">><\/code>.<\/li><\/ul>","slug":"mod_admin_frontend","is_protected":false,"visible_for":0,"tz":"UTC","language":["en"],"doc_source_hash":"6798d20717b58f1250c3f2fbe7199ede3f3805a3e5bfb9afe501ab29a73a1251","is_featured":false,"content_group_id":{"id":2551,"is_a":["meta","content_group"],"name":"content_group_imported_docs","title":"Imported documentation","uri":"https:\/\/zotonic.com\/id\/content_group_imported_docs"},"category_id":{"id":320,"is_a":["meta","category"],"name":"module","title":"Modules","uri":"https:\/\/test.zotonic.com\/id\/320"},"doc_source_path":"apps\/zotonic_mod_admin_frontend\/src\/mod_admin_frontend.erl","publication_start":"2023-06-24T08:17:46Z","github_url":"https:\/\/github.com\/zotonic\/zotonic\/blob\/master\/apps\/zotonic_mod_admin_frontend\/src\/mod_admin_frontend.erl","pivot_location_lng":null,"doc_source_kind":"module","name":"doc_module_mod_admin_frontend","is_unfindable":false,"is_published":true,"pivot_geocode":null,"created":"2020-05-30T05:47:38Z","uri":null,"doc_status":"current","is_dependent":false,"erlang_app":"zotonic_mod_admin_frontend","publication_end":"9999-06-01T00:00:00Z","modifier_id":{"id":1,"is_a":["person"],"name":"administrator","title":"Site Administrator","uri":"https:\/\/zotonic.com\/id\/1"},"privacy":0,"doc_source_commit":"66cb145eae7002b184e7d8c4c7bba5e53e8248e5\n","creator_id":{"id":336,"is_a":["person","robot"],"name":"gitbot","title":"Git","uri":"https:\/\/zotonic.com\/id\/336"},"modified":"2026-10-02T12:40:21Z","title_slug":"mod_admin_frontend"},"uri":"https:\/\/zotonic.com\/id\/1822","uri_template":"https:\/\/zotonic.com\/id\/:id","websub":{"hub":"https:\/\/zotonic.com\/.zotonic\/websub","topic":"https:\/\/zotonic.com\/.zotonic\/websub\/topic\/1822"}},"status":"ok"}