OCodeInsert v1.1.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. It does not control where the snippet runs — that is Location.

Injection locations

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 & 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), CodeMirror code editor (mode switches on type change), Targeting (page types, URL patterns, user condition), and an Active checkbox to save as draft.

Duplicate & export

Duplicate: Click the copy icon in Actions. The copy gets a new ID, (Copy) appended to the title, and is saved as inactive by default.

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",
  "active":         true,
  "priority":       10,
  "pages":          "",
  "page_types":     ["all"],
  "user_condition": "all",
  "created":        "2025-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 (max 50 entries). Columns: Time, Snippet ID, Message. Click Clear Log to delete all entries.

Activating safe mode

https://example.com/my-page/?oci_safe=1

Diagnosing issues

Evaluation order

All conditions must pass for a snippet to be injected:

• 1Is the plugin globally enabled?
• 2Is Safe Mode active?
• 3Is ?oci_safe=1 in the current URL?
• 4Does the snippet pass page type targeting?
• 5Does the snippet pass user condition?
• 6Does the snippet pass URL pattern matching?
• 7Is the snippet set to active?

Options stored

Snippet schema

JSON{
  "id":             "uuid-v4",
  "title":          "string",
  "type":           "html | js | css",
  "code":           "string (raw code)",
  "location":       "head | before_content | after_content | footer",
  "active":         true,
  "priority":       10,
  "pages":          "comma-separated URL patterns or empty string",
  "page_types":     ["all"],
  "user_condition": "all | logged_in | logged_out",
  "created":        "Y-m-d H:i:s"
}

Uninstall

Deleting via Plugins → Delete (not just deactivating) runs uninstall.php and removes oci_code_snippets, oci_settings, and oci_error_log.

WP-CLI commands (Pro)

BASHwp oci list                          # List all snippets
wp oci list --status=active          # Active snippets only
wp oci toggle <snippet-id>          # Toggle on/off by ID
wp oci disable-all                   # Disable all snippets
wp oci safe-mode on                  # Enable safe mode
wp oci export --file=snippets.json   # Export all snippets
wp oci import --file=snippets.json   # Import snippets

PHP API — OCI_Snippets

PHP// Get all snippets
$snippets = OCI_Snippets::get_all();

// Get a single snippet by UUID
$snippet = OCI_Snippets::get_by_id( 'uuid' );

// Save (create or update)
$id = OCI_Snippets::save_snippet([
    'id'             => '',        // empty = create new
    'title'          => 'My Script',
    'type'           => 'js',      // html | js | css
    'code'           => 'alert(1);',
    'location'       => 'footer',  // head | before_content | after_content | footer
    'active'         => true,
    'priority'       => 10,
    'pages'          => '',        // comma-separated URL patterns
    'page_types'     => ['all'],
    'user_condition' => 'all',     // all | logged_in | logged_out
]);

// Delete
OCI_Snippets::delete_snippet( 'uuid' );

// Toggle active state — returns new state (bool)
$is_active = OCI_Snippets::toggle_snippet( 'uuid' );

// Force-disable (always sets active=false)
OCI_Snippets::disable_snippet( 'uuid' );

// Duplicate — returns new ID
$new_id = OCI_Snippets::duplicate_snippet( 'uuid' );

PHP API — OCI_Settings

PHP$settings   = OCI_Settings::get_all();
$enabled    = OCI_Settings::is_enabled();
$safe_mode  = OCI_Settings::is_safe_mode();
$can_access = OCI_Settings::can_access();

// Error log
OCI_Settings::log_error( 'uuid', 'Error message' );
$log = OCI_Settings::get_error_log();
OCI_Settings::clear_error_log();

AJAX endpoints

All endpoints require nonce (from ociAdmin.nonce) and manage_options capability. Return wp_send_json_success() or wp_send_json_error().

Constants

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

Hooks (Pro)

PHP// Action: fires before a snippet is injected
add_action( 'oci_before_inject', function( array $snippet, string $location ) {
    // $location = 'head' | 'before_content' | 'after_content' | 'footer'
}, 10, 2 );

// Filter: decide whether a snippet should be injected
add_filter( 'oci_should_inject', function( bool $should, array $snippet ): bool {
    if ( $snippet['title'] === 'My Script' ) return false;
    return $should;
}, 10, 2 );

// Helper: get all active snippets for a location
$snippets = oci_get_snippets( 'head' );