{"result":{"depiction_url":null,"edges":{"relation":{"objects":[{"created":"2026-10-07T11:13:27Z","object_id":{"id":1576,"is_a":["text","documentation","cookbook"],"name":"doc_cookbook_writing_module","title":{"_type":"trans","tr":{"en":"Create a reusable module"}},"uri":"https:\/\/zotonic.com\/id\/1576"},"seq":1},{"created":"2026-10-07T11:13:27Z","object_id":{"id":2962,"is_a":["text","documentation","developerguide"],"name":"developer_schema_upgrades","title":{"_type":"trans","tr":{"en":"Upgrade a module's data schema"}},"uri":"https:\/\/zotonic.com\/id\/2962"},"seq":2},{"created":"2026-10-07T11:13:27Z","object_id":{"id":2953,"is_a":["text","documentation","developerguide"],"name":"developer_content_edges","title":{"_type":"trans","tr":{"en":"Connect resources and preserve order"}},"uri":"https:\/\/zotonic.com\/id\/2953"},"seq":3}],"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-10-07T11:13:27Z","object_id":{"id":2554,"is_a":["categorization","keyword","keyword_information_type"],"name":"zotonic_topic_how_to_guide","title":"How-to guide","uri":"https:\/\/zotonic.com\/id\/2554"},"seq":1},{"created":"2026-10-07T11:13:27Z","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:27Z","object_id":{"id":2568,"is_a":["categorization","keyword","keyword_domain"],"name":"zotonic_topic_content_modeling","title":"Content modeling","uri":"https:\/\/zotonic.com\/id\/2568"},"seq":3},{"created":"2026-10-07T11:13:27Z","object_id":{"id":2614,"is_a":["categorization","keyword","keyword_architecture"],"name":"zotonic_topic_resource","title":"Resource","uri":"https:\/\/zotonic.com\/id\/2614"},"seq":4},{"created":"2026-10-07T11:13:27Z","object_id":{"id":2635,"is_a":["categorization","keyword","keyword_architecture"],"name":"zotonic_topic_module","title":"Module","uri":"https:\/\/zotonic.com\/id\/2635"},"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":2955,"is_a":["text","documentation","developerguide"],"links":[{"rel":"self","target":"https:\/\/zotonic.com\/.zotonic\/websub\/topic\/2955"},{"rel":"hub","target":"https:\/\/zotonic.com\/.zotonic\/websub"}],"medium":null,"medium_url":null,"name":"developer_datamodel_fixtures","page_url":{"en":"https:\/\/zotonic.com\/docs\/2955\/install-initial-content-with-a-datamodel","x-default":"https:\/\/zotonic.com\/docs\/2955\/install-initial-content-with-a-datamodel"},"preview_url":null,"resource":{"body":{"_type":"trans","tr":{"en":"

Use a datamodel for resources that a module needs on installation. Add this declaration and callback to the mod_garden.erl<\/code> from the module-creation task:<\/p>\n

-include_lib("zotonic_core\/include\/zotonic.hrl").\n-mod_schema(1).\n-export([manage_schema\/2]).\n\n-spec manage_schema(Version, Context) -> Datamodel\n    when Version :: install | {upgrade, pos_integer()},\n         Context :: z:context(),\n         Datamodel :: #datamodel{}.\nmanage_schema(install, _Context) ->\n    #datamodel{\n        resources = [\n            {garden_welcome, text, #{\n                <<"title">> => <<"Welcome to the garden">>,\n                <<"is_published">> => false\n            }}\n        ]\n    }.\n<\/code><\/pre>\n
Put declarations before functions and include the header only once. Compile and activate the module on a fresh local database-backed site. The module manager applies the returned datamodel; do not call the callback manually expecting it to create data. Confirm m_rsc:rid(garden_welcome, C)<\/code> returns an ID and find the unpublished page in the admin.<\/p>\n
A module already installed with a schema version needs an explicit upgrade step for later changes. Give managed resources stable names, and decide which properties editors own. Test with an edited title before applying an upgrade: returning defaults must not be treated as permission to replace editorial work.<\/p>"}},"category_id":{"id":317,"is_a":["meta","category"],"name":"developerguide","title":"Developer guide","uri":"https:\/\/zotonic.com\/id\/developerguide"},"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":"2026-10-07T11:12:56Z","creator_id":{"id":1,"is_a":["person"],"name":"administrator","title":"Site Administrator","uri":"https:\/\/zotonic.com\/id\/1"},"doc_editorial_bundle":true,"doc_editorial_edges":{"relation":[1576,2953,2962],"subject":[2554,2564,2568,2614,2635]},"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:34Z","modifier_id":{"id":1,"is_a":["person"],"name":"administrator","title":"Site Administrator","uri":"https:\/\/zotonic.com\/id\/1"},"name":"developer_datamodel_fixtures","pivot_geocode":null,"pivot_location_lat":null,"pivot_location_lng":null,"privacy":0,"publication_end":"9999-06-01T00:00:00Z","publication_start":"2026-10-07T11:12:56Z","slug":"install-initial-content-with-a-datamodel","summary":{"_type":"trans","tr":{"en":"Use a datamodel for application-owned categories, predicates, resources, and relationships that must exist when a module is installed."}},"title":{"_type":"trans","tr":{"en":"Install initial content with a datamodel"}},"title_slug":{"_type":"trans","tr":{"en":"install-initial-content-with-a-datamodel"}},"tz":"UTC","uri":null,"version":20,"visible_for":0},"uri":"https:\/\/zotonic.com\/id\/2955","uri_template":"https:\/\/zotonic.com\/id\/:id","websub":{"hub":"https:\/\/zotonic.com\/.zotonic\/websub","topic":"https:\/\/zotonic.com\/.zotonic\/websub\/topic\/2955"}},"status":"ok"}