Troubleshooting
Templates menu does not appear
If Page Builder is active, the menu mounts under Orravo Theme as a submenu (add_submenu_page). If it is not, the plugin falls back to a top-level Orravo Templates menu. If you see neither, check the register_menu hook ran - confirm the plugin is active and manage_options is granted.
Cloud templates are missing
The cloud catalog is cached for 12 hours. To force a refresh:
bashcurl -X POST -H 'X-WP-Nonce: <nonce>' \
'https://your-site/wp-json/orravo-templates/v1/sync'Or in the library UI, click Sync in the toolbar. Behind the scenes this calls Orv_Tpl_Fetcher::cloud_catalog( true ) which bypasses the cache.
Import fails halfway through
The importer is idempotent - re-run it. Each call reuses existing posts marked with _orv_tpl_key rather than duplicating. Check wp-content/debug.log for the specific page that failed.
Images are missing on imported pages
Open the library. Failed sideloads appear as an admin notice listing URL + reason. Common causes: image host blocks cross-origin requests, response is HTML not an image, or the WP install has filesystem permissions blocking media writes.
Legacy demo seed shows up under a one-time notice
The activation hook spotted one of the old orravo_demo_seed* options. Dismiss the notice when you have either imported a new template or deleted the old seed pages.
Plugin row meta says "Cloud sync, one-click import, image side-loading"
That is intentional. It is a discoverability hint added under Plugins, so when you scan the list you know the plugin actually does something.