OCodeInsert v2.0.0

From WordPress admin

Manual (FTP / SFTP)

Snippet types

The Type field drives syntax highlighting, auto-wrap logic, and the visual badge in the list. Where the snippet runs is controlled by Location.

Injection locations (11 + 7 OTheme)

Page type targeting

URL pattern targeting

Comma-separated URL paths relative to the domain root. Matched against $_SERVER['REQUEST_URI']. Case-insensitive, trailing slashes ignored. Applied in addition to Page Type; both must pass.

/about, /blog/*, /shop/product-category/*

User condition, role, device, schedule, status, priority

Snippets list columns

The filter toolbar supports live search by title (client-side) and filtering by Type, Status, and Location.

Snippet editor

Click + New Snippet or the edit icon on any row. The modal contains: Basic Info (title, type, location, priority, status), CodeMirror code editor (mode switches on type change), Targeting (page types, URL patterns, user condition, user role, device, schedule start/end, paragraph N), and the OIntel linter panel which surfaces errors and warnings before save. The snippet library is also reachable from the editor for placeholder-driven imports.

Duplicate & export

Duplicate: Click the copy icon in Actions. The copy gets a new UUID, (Copy) appended to the title, and is saved with status='draft'.

Export single snippet Free: Click the download icon to export a snippet as .json, generated client-side.

JSON{
  "id":             "...",
  "title":          "My Snippet",
  "type":           "js",
  "code":           "console.log('hello');",
  "location":       "head",
  "status":         "published",
  "priority":       10,
  "page_types":     ["all"],
  "pages":          "",
  "user_condition": "all",
  "user_role":      "all",
  "device":         "all",
  "schedule_start": "",
  "schedule_end":   "",
  "paragraph_num":  1,
  "created":        "2026-01-01 12:00:00",
  "updated":        "2026-01-01 12:00:00"
}

Global enable / disable

Master switch for the entire plugin. When disabled: no snippets are injected anywhere, the admin interface remains accessible, and all snippet data is preserved. Useful for temporary maintenance or debugging without deactivating the plugin.

Role permissions

Choose which WordPress roles can access the OCodeInsert admin panel. Administrators always have access. Default: Administrators only. Adding Editor lets editors manage snippets without full admin access.

Error log

Maintains an internal log of issues during snippet processing in the oci_error_log option (capped at 500 entries; oldest are sliced off). Columns: Time, Snippet ID, Message. Click Clear Log to delete all entries. Auto-recovery entries are tagged with snippet_id = system.

Activating safe mode

https://example.com/my-page/?oci_safe=1
# admin bar reads:  ⚠ OCI Safe Mode (auto)  when triggered by the shutdown handler

Diagnosing issues

Evaluation order

All conditions must pass for a snippet to fire:

• 1Is the plugin globally enabled (enabled)?
• 2Is Safe Mode off (safe_mode)?
• 3If ?oci_safe=1 is set, does the user have manage_options? (If yes, snippets are bypassed.)
• 4Snippet status is published?
• 5Schedule (start / end) currently in range?
• 6Page type matches (or page_types contains all)?
• 7User condition matches (logged-in / logged-out)?
• 8URL pattern matches (or no patterns set)?
• 9Device matches (mobile / desktop / all)?
• 10User role matches (or set to all)?
• 11If type='php': oci_is_pro() returns true?

Tables

Options stored

Snippet schema (hydrated)

JSON{
  "id":             "uuid-v4",
  "title":          "string",
  "type":           "html | js | css | php",
  "code":           "string (raw)",
  "location":       "head | footer | before_content | after_content | after_paragraph | before_comments | after_comments | login_page | 404_page | search_results | admin_head | orravo_*",
  "status":         "published | draft | paused | archived",
  "priority":       10,
  "page_types":     ["all" | "front" | "single" | "archive" | "search" | "404"],
  "pages":          "comma-separated URL patterns; * is a wildcard",
  "user_condition": "all | logged_in | logged_out",
  "user_role":      "all | ",
  "device":         "all | mobile | desktop",
  "schedule_start": "Y-m-d H:i:s or empty",
  "schedule_end":   "Y-m-d H:i:s or empty",
  "paragraph_num":  1,
  "created":        "Y-m-d H:i:s",
  "updated":        "Y-m-d H:i:s"
}

Migration from v1

v1 stored snippets in a single JSON-encoded option (oci_code_snippets). On first load of v2, OCI_DB::maybe_migrate_from_options() walks that array, inserts each snippet into the new oci_snippets table with default targeting, copies the original payload to oci_code_snippets_v1_backup, and deletes oci_code_snippets. The backup option is kept so admins can verify the migration before manually deleting it.

Uninstall

Deleting via Plugins → Delete runs uninstall.php, which calls OCI_DB::drop_tables() to drop all 3 custom tables and removes the related options. Deactivation alone leaves the data in place.

Free in v2.0.0

Pro license unlocks

PHP API: OCI_Snippets

PHP// Read
$snippets = OCI_Snippets::get_all( $include_archived = false );
$snippet  = OCI_Snippets::get_by_id( 'uuid' );

// Save (create when 'id' is empty, otherwise update + auto-revision)
$id = OCI_Snippets::save_snippet([
    'id'             => '',                 // empty = create new (uuid v4 generated)
    'title'          => 'My Script',
    'type'           => 'js',               // html | js | css | php
    'code'           => 'alert(1);',
    'location'       => 'footer',           // any of LOCATIONS or THEME_LOCATIONS
    'status'         => 'published',        // published | draft | paused | archived
    'priority'       => 10,
    'page_types'     => ['all'],
    'pages'          => '',                 // comma-separated patterns; * is wildcard
    'user_condition' => 'all',              // all | logged_in | logged_out
    'user_role'      => 'all',
    'device'         => 'all',              // all | mobile | desktop
    'schedule_start' => '',
    'schedule_end'   => '',
    'paragraph_num'  => 1,
]);

// Lifecycle
OCI_Snippets::set_status( 'uuid', 'paused' );
$new_status = OCI_Snippets::toggle_snippet( 'uuid' ); // 'published' <-> 'paused'
OCI_Snippets::disable_snippet( 'uuid' );              // shortcut for set_status('paused')
$copy_id = OCI_Snippets::duplicate_snippet( 'uuid' ); // creates draft '... (Copy)'
OCI_Snippets::delete_snippet( 'uuid' );               // also deletes revisions + log rows

// Revisions
$ok = OCI_Snippets::restore_revision( $revision_id ); // saves current as new revision then loads
$rows = OCI_DB::get_revisions( 'uuid' );              // up to 25, newest first

// Render helpers
$html = OCI_Snippets::prepare_code_public( $snippet );

PHP API: OCI_Settings, OCI_DB, OCI_Linter, OCI_Library

PHP// Settings
$settings   = OCI_Settings::get_all();
$enabled    = OCI_Settings::is_enabled();
$safe_mode  = OCI_Settings::is_safe_mode();
$can_access = OCI_Settings::can_access();
OCI_Settings::enable_safe_mode( 'manual' );    // or 'auto'
OCI_Settings::disable_safe_mode();
OCI_Settings::log_error( 'uuid', 'message' );
$log = OCI_Settings::get_error_log();           // capped at 500 entries

// Recovery URL token (24h, single-use)
$url = OCI_Settings::get_recovery_url();

// Execution log (oci_execution_log)
$last = OCI_DB::get_last_fired( 'uuid' );
$rows = OCI_DB::get_execution_log( 'uuid', 20 );
$has  = OCI_DB::snippet_has_errors( 'uuid' );

// Linter
$report = OCI_Linter::lint( $snippet );  // ['errors' => [...], 'warnings' => [...]]

// Library (built-in templates with placeholders)
$cats   = OCI_Library::get_categories();
$saveable = OCI_Library::prepare_for_save( $library_id, [ 'GA_ID' => 'G-XXX' ] );
$id = OCI_Snippets::save_snippet( $saveable );

// Pro entitlement check
if ( oci_is_pro() ) { /* PHP snippets allowed */ }

Shortcode

HTML[ocodeinsert id="snippet-uuid"]

Renders the snippet inline inside post content. Skips snippets that are not published.

Constants

PHP// Enable PHP snippet execution in a custom build (wp-config.php or must-use plugin)
define( 'OCI_PRO', true );

Filters

PHP// Register OCodeInsert with the Orravo Mini-Core (already wired by the plugin)
add_filter( 'orravo_register_product', function( array $p ): array {
    return array_merge( $p, [ 'ocodeinsert' => 'OCodeInsert' ] );
} );

add_filter( 'orravo_mini_admin_pages', function( array $p ): array {
    return array_merge( $p, [ 'ocodeinsert' ] );
} );