Getting started

Getting started

After activation, open Orravo Theme > Templates (or top-level Orravo Templates). The library is a single-page UI with a card grid of every available template.

First import

1. Browse the cards. Each shows title, category, summary, and required plugins.
2. Click Preview to load the template on the live theme without writing any posts.
3. Click Import to create real orv_page posts for the template's pages.
4. The card shows Imported once it lands.

What import actually does

The importer (Orv_Tpl_Importer::import) does three things:

1. Reads the template manifest from bundled/<key>/ or the cloud catalog.
2. Side-loads every remote image referenced by the manifest into the WP Media Library via Orv_Image_Sideloader.
3. Inserts one orv_page post per page in the template with _orv_pb_sections and _orv_pb_masthead meta. Existing posts with the same _orv_tpl_key are reused, never duplicated.

Importing partial content

Use the REST routes for finer control:

• POST /orravo-templates/v1/template/{key}/page - create one new page from selected sections
• POST /orravo-templates/v1/template/{key}/append/{post_id} - append selected sections to an existing post

The library UI exposes both behind a section-picker drawer.