Troubleshooting
The Orravo Theme menu does not appear
The menu is registered by Orv_PB_Admin::register_menu() on admin_menu. If it is missing:
- Confirm Orravo Page Builder is active under Plugins.
- Confirm Orravo Core is active. The plugin shows a red notice on
plugins_loadedwhen Core is missing - the builder still loads but the dashboard hero, license screen, and command palette will not. - Check
manage_optionscapability for your user. The whole menu is gated on that cap.
My orv_page URLs return 404
Flush rewrite rules. Settings > Permalinks > Save Changes. The plugin registers rewrite => [ 'slug' => 'orv' ] and that needs flushing after activation. Activation already calls flush_rewrite_rules() once, but plugins that ship rewrites can clobber the cache.
Sections from an old version look broken
The migration runs at admin_init priority 5 via Orv_PB_Migrator_Neutralization::maybe_run(). If it has not run, deactivate then reactivate the plugin to trigger the migration. The migration is idempotent - the option flag prevents repeat runs.
Cmd+K does not open the palette
The palette only enqueues on Orravo admin screens (orv-pb- and orravo-). If you are on another screen, the keyboard shortcut is intentionally inert.
Section preview thumbnails are blank
Orv_Pb_Screenshot writes to wp-content/uploads/orv-screenshots/. Check the directory is writable. If permissions are fine, regenerate by editing a section field and refreshing the picker - cached entries are keyed on the field hash.
Builder page renders the front-page template instead
If the static front page itself is a builder page, the theme's front-page.php would normally take precedence over page-orv.php. Orv_PB_CPT::template_include fixes this by detecting builder data and forcing page-orv.php. Make sure no other plugin filters template_include at higher priority.