Skip to content

Preferences

Jump to bottom
Richard Kent Gates edited this page Mar 6, 2026 · 1 revision

Preferences

Navigate to Scriptomatic → Preferences to configure plugin-wide settings.

Settings Keys

Key Type Default Range / Notes
max_log_entries integer 200 3–1,000. Sets how many activity log entries are retained. When reduced, oldest entries are pruned immediately.
keep_data_on_uninstall bool false When true, all plugin data (options, DB tables, JS files) is retained after the plugin is deleted.
save_confirm_enabled bool true When true, a confirmation dialog appears before any save.
api_enabled bool true (Pro) Enable or disable the REST API site-wide. When false, all REST requests return 503 rest_api_disabled.
api_allowed_ips string '' (empty) (Pro) Newline-separated IPv4, IPv6, or IPv4 CIDR ranges. Empty = allow all IPs. Blocked requests return 403 rest_ip_forbidden.
api_allowed_users array [] (empty) (Pro) Array of administrator user IDs allowed to use the REST API. Empty = allow any administrator. Blocked requests return 403 rest_user_forbidden.

Email Notification Opt-In

Each administrator's email notification preference is stored per-user:

  • Site admin (admin_email option) — always receives notifications, regardless of this setting
  • Other administrators — can opt in via Users → Profile → Scriptomatic Notifications checkbox

See the Email Notifications page for full details.

Preferences Action History

The bottom of the Preferences page shows the Preferences Action History — a read-only audit trail of all preference changes:

  • Last 100 entries shown, paginated 20/page with AJAX Prev/Next navigation
  • Columns: Date/Time, User, Via (Dashboard / API / CLI), Changes
  • No Restore button — preference changes are audited only, not snapshotted

Accessing Preferences via WP-CLI

See the full WP-CLI Reference for all commands.

# View all current preferences
wp scriptomatic prefs get
wp scriptomatic prefs get --format=json

# Set a preference
wp scriptomatic prefs set --key=max_log_entries --value=500
wp scriptomatic prefs set --key=keep_data_on_uninstall --value=true
wp scriptomatic prefs set --key=save_confirm_enabled --value=false
wp scriptomatic prefs set --key=api_enabled --value=true           # Pro
wp scriptomatic prefs set --key=api_allowed_ips --value="203.0.113.0/24"  # Pro
wp scriptomatic prefs set --key=api_allowed_users --value="admin,editor2" # Pro

# View preferences change history
wp scriptomatic prefs history
wp scriptomatic prefs history --format=json

Note: Preferences management is available via the Dashboard and WP-CLI only — intentionally absent from the REST API.

← Home

Clone this wiki locally