OFeedback v2.0.0

Via ZIP upload (recommended)

Via FTP / file manager

On activation

• The wp_ofb_feedback database table is created (or upgraded via dbDelta if an older version exists).
• A daily WP-Cron event (ofb_cleanup_screenshots) is scheduled to delete screenshot files from archived entries older than 30 days.

Status tabs

Table columns

Checkbox · From (name + email) · Type tag · Message excerpt · Rating · Screenshot indicator · Page · Date · Status badge · Row actions

Filters & bulk actions

Stat cards

Charts

• Submissions by Type — horizontal bar chart per feedback type
• Rating Distribution — bars for each star value (1–5)
• Last 30 Days — vertical bar chart with one bar per day; missing days shown as zero

Widget structure

Trigger modes

Auto-fill & exclusions

Logged-in users have their display_name and user_email pre-filled via wp_localize_script — no client-side fetch required.

Post/page IDs listed under Settings → Show/Hide Rules → Excluded Post IDs will not render the widget, even when globally enabled.

Recipients

Settings → Email Notifications → Notification Recipients. Enter one email per line, or comma-separated. Multiple recipients are supported.

Email contents

Type, name, email, subject, star rating, page link, full message body, and a View in OFeedback CTA button styled with the Orravo orange accent.

Submitter confirmation

When Send confirmation email to submitter is enabled and the submitter provides an email address, they receive a receipt email containing their own message.

Capture process

Cleanup & security

A daily WP-Cron job deletes screenshot files belonging to entries archived more than 30 days ago. Trigger manually at Settings → Screenshot Storage → Run Cleanup Now.

The ofb-screenshots/ directory is protected by a .htaccess file that disables directory listing and blocks PHP execution.

ofeedback_submission_created

Fires immediately after a new submission is saved to the database, after email and Slack notifications have been sent.

PHPadd_action( 'ofeedback_submission_created', function( int $id, array $data ) {
    // $id   — The new row ID in wp_ofb_feedback
    // $data — Sanitized submission array (type, message, name, email, rating, …)
    error_log( 'New feedback #' . $id . ' from ' . ( $data['name'] ?: 'Anonymous' ) );
}, 10, 2 );

// Zapier / Make integration example
add_action( 'ofeedback_submission_created', function( $id, $data ) {
    wp_remote_post( 'https://hooks.zapier.com/...', [
        'body'    => wp_json_encode( array_merge( ['id' => $id], $data ) ),
        'headers' => ['Content-Type' => 'application/json'],
    ]);
}, 10, 2 );

ofb_notify_email

Filters the notification recipient(s) before the admin email is sent. Receives the string of addresses (comma-separated or single).

PHPadd_filter( 'ofb_notify_email', function( string $email ): string {
    return 'feedback@example.com, team@example.com';
} );

OFB_DB::query()

PHP$submissions = OFB_DB::query([
    'status'    => 'new',         // '', 'new', 'read', 'archived'
    'type'      => 'bug',         // '', 'general', 'bug', 'suggestion', …
    'search'    => 'login page',  // full-text across name, email, subject, message
    'date_from' => '2025-01-01',  // Y-m-d
    'date_to'   => '2025-12-31',  // Y-m-d
    'orderby'   => 'created_at',  // id, name, email, type, rating, status, created_at
    'order'     => 'DESC',        // ASC or DESC
    'per_page'  => 20,
    'paged'     => 1,
]);
// Returns array of stdClass objects

OFB_DB::get()

PHP$entry = OFB_DB::get( 42 );
if ( $entry ) {
    echo $entry->name . ': ' . $entry->message;
}

Analytics methods

Data collected per submission

• Message (required)
• Type, subject, rating (form fields)
• Name, email (optional — submitter-provided)
• Page URL and page title (from window.location and document.title)
• IP address (optional — disable via Settings → Privacy)
• Browser user agent string
• WordPress user ID (if the submitter is logged in)

Compliance checklist