Changeset 3666532

neutrope-lead-desk-for-contact-form-7/tags/0.3.0/admin/class-admin-menu.php

-              r3666139
+              r3666532
                         $message .= ' ' . esc_html(
                                 sprintf(
                                         /* translators: 1: number of records processed, 2: total records, 3: percentage complete */
                                         __( '%1$s of %2$s (%3$s%%)', 'neutrope-lead-desk-for-contact-form-7' ),
+                                        /* translators: 1: number of records processed, 2: total records to process, 3: percentage complete. "Records" counts processing units (entries plus notes), NOT the number of inquiries. */
+                                        __( 'Processed %1$s of %2$s records (%3$s%%).', 'neutrope-lead-desk-for-contact-form-7' ),
                                         number_format_i18n( (int) $progress['processed'] ),
                                         number_format_i18n( (int) $progress['total'] ),

neutrope-lead-desk-for-contact-form-7/tags/0.3.0/admin/class-entry-detail-page.php

-              r3666139
+              r3666532
                 $backfill_pending = class_exists( 'NLDCF7_Event_Backfill' ) && NLDCF7_Event_Backfill::is_pending();
+                // The "history from before this plugin was updated" note only makes
+                // sense where there IS such history. The migration snapshot records how
+                // much there was to reconstruct at upgrade time: both totals are zero on
+                // a site that installed this version fresh, and the note is then simply
+                // untrue. The snapshot is used rather than today's entry count because
+                // entries received since the upgrade say nothing about what came before.
+                //
+                // If the snapshot is missing or unreadable the note is shown: an
+                // unnecessary explanation is a smaller harm than silently omitting the
+                // one that tells an admin why their older entries look sparse.
+                $show_history_note = true;
+                if ( class_exists( 'NLDCF7_Event_Backfill' ) && NLDCF7_Event_Backfill::is_initialised() ) {
+                        $backfill_state = NLDCF7_Event_Backfill::get_state();
+                        if ( isset( $backfill_state['entry_total'], $backfill_state['note_total'] ) ) {
+                                $show_history_note = ( (int) $backfill_state['entry_total'] > 0 )
+                                        || ( (int) $backfill_state['note_total'] > 0 );
+                        }
+                }
                 if ( $this->event_repo ) {
                         $events_total       = $this->event_repo->count_for_entry( (int) $entry['id'] );

neutrope-lead-desk-for-contact-form-7/tags/0.3.0/admin/class-entry-list-table.php

-              r3666139
+              r3666532
+                }
+                return $args;
+                return self::apply_carried_args_filter( $args );
+        }
+        /**
+         * Maximum number of add-on contributed args carried in a list URL.
+         */
+        const CARRIED_MAX_ARGS = 20;
+        /**
+         * Maximum length of a single carried value, in characters.
+         */
+        const CARRIED_MAX_VALUE = 200;
+        /**
+         * Query keys an add-on may never contribute to a carried list URL.
+         *
+         * `page` is here because Free sets it itself; `paged` because v0.2.0
+         * deliberately returns to the first page after an action; the rest are
+         * mutation, authentication or routing state that must never be replayed
+         * from a link the admin can bookmark or share.
+         *
+         * @var string[]
+         */
+        private static $carried_denylist = array(
+                'page',
+                'paged',
+                'action',
+                'action2',
+                'entry_id',
+                '_wpnonce',
+                '_wp_http_referer',
+                'view',
+                'event_page',
+                self::VIEW_QUERY_VAR,
+        );
+        /**
+         * Let add-ons contribute their own filter state, then re-impose Free's rules.
+         *
+         * Everything an add-on adds is treated as untrusted: the deny-list, key
+         * normalisation, scalar-only rule and size caps are applied AFTER the
+         * filter, so a careless listener cannot put `_wpnonce` or an array back
+         * into a URL. Core args are re-applied last and always win.
+         *
+         * This is the one place custom filter state enters a list URL. Every path
+         * that needs it -- the All/Trash views, the row actions, and the redirect
+         * after a row or bulk action -- reaches it through current_filter_args(),
+         * so there is a single implementation rather than one per call site.
+         *
+         * @param array<string,string|int> $core Sanitized core filter args.
+         * @return array<string,string|int>
+         */
+        private static function apply_carried_args_filter( array $core ) {
+                /**
+                 * Filter the list state carried across view switches and row/bulk actions.
+                 *
+                 * Add-ons append their own already-sanitized scalar args. Free re-checks
+                 * the result regardless; see the class constants for the size caps and
+                 * `$carried_denylist` for the keys that are always stripped.
+                 *
+                 * Free never forwards the raw query string, so an add-on filter that
+                 * adds nothing leaves the URL byte-identical to v0.2.0.
+                 *
+                 * @since 0.3.0
+                 *
+                 * @param array<string,string|int> $args Args to carry. Core keys included.
+                 * @param array<string,string|int> $core The core args, for reference.
+                 */
+                $filtered = apply_filters( 'nldcf7_entry_list_carried_args', $core, $core );
+                if ( ! is_array( $filtered ) ) {
+                        return $core;
+                }
+                $extra = array();
+                foreach ( $filtered as $key => $value ) {
+                        if ( count( $extra ) >= self::CARRIED_MAX_ARGS ) {
+                                self::debug_carried( 'too many carried args; extra dropped' );
+                                break;
+                        }
+                        $key = sanitize_key( (string) $key );
+                        if ( '' === $key || array_key_exists( $key, $core ) ) {
+                                // Empty/unusable key, or a core key -- core is authoritative and
+                                // is re-applied below either way.
+                                continue;
+                        }
+                        if ( in_array( $key, self::$carried_denylist, true ) ) {
+                                self::debug_carried( 'reserved key refused: ' . $key );
+                                continue;
+                        }
+                        if ( ! is_scalar( $value ) ) {
+                                // Arrays and objects are dropped outright. Casting one would
+                                // print the literal string "Array" into a URL.
+                                self::debug_carried( 'non-scalar value dropped for key: ' . $key );
+                                continue;
+                        }
+                        $value = (string) $value;
+                        if ( '' === $value ) {
+                                continue;
+                        }
+                        if ( function_exists( 'mb_substr' ) ) {
+                                $value = mb_substr( $value, 0, self::CARRIED_MAX_VALUE );
+                        } else {
+                                $value = substr( $value, 0, self::CARRIED_MAX_VALUE );
+                        }
+                        $extra[ $key ] = sanitize_text_field( $value );
+                }
+                // Core last: an add-on cannot override the screen's own filter state.
+                return array_merge( $extra, $core );
+        }
+        /**
+         * Log a rejected carried-arg contribution while debugging.
+         *
+         * @param string $message
+         * @return void
+         */
+        private static function debug_carried( $message ) {
+                if ( defined( 'WP_DEBUG' ) && WP_DEBUG ) {
+                        // phpcs:ignore WordPress.PHP.DevelopmentFunctions.error_log_error_log -- Gated by WP_DEBUG; an add-on silently losing filter state is otherwise very hard to diagnose.
+                        error_log( '[neutrope-lead-desk-for-contact-form-7] carried args: ' . $message );
+                }
+        }
 …
         public function get_columns() {
                 return array(
+                $core = array(
                         'cb'                => '<input type="checkbox" />',
                         'submitted_at'      => __( 'Received', 'neutrope-lead-desk-for-contact-form-7' ),
 …
                         'note_count'        => __( 'Notes', 'neutrope-lead-desk-for-contact-form-7' ),
                 );
+                /**
+                 * Filter the entries list columns.
+                 *
+                 * Add-ons may append their own columns. They may NOT remove, rename or
+                 * repurpose a core column: every core key is restored to its own label
+                 * after this filter runs, so reusing one silently changes nothing. That
+                 * is enforced in code rather than left to convention, because a column
+                 * whose header says one thing and whose cells say another is a data
+                 * integrity problem, not a styling preference.
+                 *
+                 * Cells for added columns are rendered through
+                 * `nldcf7_entry_list_column_content`.
+                 *
+                 * @since 0.3.0
+                 *
+                 * @param array<string,string> $columns column key => header label.
+                 */
+                $filtered = apply_filters( 'nldcf7_entry_list_columns', $core );
+                if ( ! is_array( $filtered ) ) {
+                        return $core;
+                }
+                // Keep only usable entries: a non-empty sanitize_key()-able key mapped
+                // to a scalar label. Anything else is a malformed contribution and is
+                // dropped rather than being allowed to break the header row.
+                $clean = array();
+                foreach ( $filtered as $key => $label ) {
+                        $key = sanitize_key( (string) $key );
+                        if ( '' === $key || ! is_scalar( $label ) ) {
+                                continue;
+                        }
+                        $clean[ $key ] = (string) $label;
+                }
+                // Core wins: restore every core column's own label, and re-add any the
+                // filter dropped. `cb` goes back to the front so the bulk-select box
+                // never ends up mid-row.
+                foreach ( $core as $key => $label ) {
+                        $clean[ $key ] = $label;
+                }
+                if ( isset( $clean['cb'] ) ) {
+                        $cb = $clean['cb'];
+                        unset( $clean['cb'] );
+                        $clean = array_merge( array( 'cb' => $cb ), $clean );
+                }
+                return $clean;
+        }
+        /**
+         * Render a cell for a column this class has no `column_{key}()` method for.
+         *
+         * Only add-on columns reach here: every core column has its own method.
+         * WordPress core's own `column_default()` is an empty no-op, so without
+         * this an added column would render as a blank cell.
+         *
+         * The listener returns HTML and is responsible for escaping it; Free then
+         * runs the result through `wp_kses_post()` as a second layer, which is the
+         * reason this is a filter with a return value rather than an action that
+         * echoes -- output that Free never sees is output Free cannot make safe.
+         *
+         * @param array  $item        Entry row.
+         * @param string $column_name Column key.
+         * @return string Escaped HTML, or '' when nothing is contributed.
+         */
+        public function column_default( $item, $column_name ) {
+                /**
+                 * Filter the cell content for an add-on column on the entries list.
+                 *
+                 * @since 0.3.0
+                 *
+                 * @param string $html        Cell HTML. Default ''.
+                 * @param string $column_name Column key being rendered.
+                 * @param array  $item        Entry row, as stored.
+                 */
+                $html = apply_filters( 'nldcf7_entry_list_column_content', '', (string) $column_name, $item );
+                if ( ! is_string( $html ) || '' === $html ) {
+                        return '';
+                }
+                return wp_kses_post( $html );
+        }
 …
                         </label>
+                        <?php submit_button( __( 'Filter', 'neutrope-lead-desk-for-contact-form-7' ), '', 'nldcf7-filter-submit', false ); ?>
+                        <?php
+                        /**
+                         * Fires inside the entries list filter bar, before the Filter button.
+                         *
+                         * Listeners print their own form controls here. The position is
+                         * guaranteed to be inside the existing GET form, so a plain
+                         * `<select>` or `<input>` submits with the core filters and needs
+                         * nothing else wired up.
+                         *
+                         * No nonce is involved: this bar only reads, and Free's own filters
+                         * carry none either. The listener owns its field names, its values
+                         * and its escaping; Free owns only the placement.
+                         *
+                         * @since 0.3.0
+                         *
+                         * @param array<string,string|int> $current_args Sanitized core filter
+                         *                                               state for this request.
+                         */
+                        do_action( 'nldcf7_entry_list_filters', self::current_filter_args() );
+                        submit_button( __( 'Filter', 'neutrope-lead-desk-for-contact-form-7' ), '', 'nldcf7-filter-submit', false );
+                        ?>
                 </div>
                 <?php
 …
                         // behaving as a soft delete rather than turning into a filter.
                         'trashed_only' => ( self::VIEW_TRASH === self::current_view() ),
+                        // Identifies this caller to the query extension hooks so an add-on
+                        // can constrain the list without also constraining CSV export.
+                        'context'      => NLDCF7_Entry_Repository::CONTEXT_LIST,
                 );
 …
+                        )
                 );
+                /**
+                 * Fires once the rows for the current list page are known.
+                 *
+                 * Add-ons that render their own columns use this to load whatever they
+                 * need for these rows in one query, before any cell is rendered.
+                 * Without it they are pushed into N+1: the cell filter is handed a
+                 * single row and has no way to learn what else is on the page, so the
+                 * only alternative is a lookup per cell -- twenty rows with two custom
+                 * columns being up to forty extra queries.
+                 *
+                 * Free's own note-count cache above is the same pattern; this is that
+                 * opportunity handed to extensions.
+                 *
+                 * Contract:
+                 *   - $items is THIS PAGE's rows, never the whole result set.
+                 *   - Read-only. Listeners must not mutate the list's state, and no
+                 *     return value is used.
+                 *   - Fires exactly once per prepare cycle, including with an empty
+                 *     array when the page has no rows, so "once per cycle" holds
+                 *     without a special case for empty results.
+                 *   - The entries screen only. CSV export does not build a list table
+                 *     and so never reaches here.
+                 *   - Running the secondary query safely -- preparing it, checking
+                 *     capabilities -- belongs to the listener.
+                 *
+                 * Fired after this class has finished its own preparation so that a
+                 * listener cannot interleave with it. The repository, the controller
+                 * and this table instance are deliberately not passed.
+                 *
+                 * @since 0.3.0
+                 *
+                 * @param array<int,array<string,mixed>> $items Rows on the current page.
+                 */
+                do_action( 'nldcf7_entry_list_items_prepared', $this->items );
+        }

neutrope-lead-desk-for-contact-form-7/tags/0.3.0/admin/views/entry-detail.php

-              r3666139
+              r3666532
  *   $notice   array|null  Flash notice ['message'=>string,'type'=>string]
  *                         pulled from per-user transient (consume_notice()).
+ *   $show_history_note bool Whether the pre-upgrade history caveat applies.
+ *
  * phpcs:disable WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedVariableFound -- Locals in an included view, not actual globals.
 …
                         <div class="nldcf7-card nldcf7-timeline-card">
                                 <h2><?php esc_html_e( 'Activity', 'neutrope-lead-desk-for-contact-form-7' ); ?></h2>
+                                <p class="description">
+                                        <?php esc_html_e( 'History from before this plugin was updated is limited to what could be reconstructed: the time each entry arrived and any notes already saved.', 'neutrope-lead-desk-for-contact-form-7' ); ?>
+                                </p>
+                                <?php if ( $show_history_note ) : ?>
+                                        <p class="description">
+                                                <?php esc_html_e( 'History from before this plugin was updated is limited to what could be reconstructed: the time each entry arrived and any notes already saved.', 'neutrope-lead-desk-for-contact-form-7' ); ?>
+                                        </p>
+                                <?php endif; ?>
                                 <?php if ( empty( $events ) ) : ?>
 …
                         </div>
+                        <?php
+                        /**
+                         * Fires after the main column's own cards on the entry detail screen.
+                         *
+                         * Add-ons print their own markup here -- including the surrounding
+                         * `<div class="nldcf7-card">` -- and own escaping it. Nothing is
+                         * buffered or filtered on the way out, so a listener that prints
+                         * nothing costs nothing and leaves the page byte-identical.
+                         *
+                         * The position is deliberately "after every core card" rather than
+                         * between two of them: card order is an internal detail that may
+                         * change, and a between-cards contract could not be kept stable.
+                         *
+                         * @since 0.3.0
+                         *
+                         * @param array $entry Entry row, as stored. Passed by value.
+                         */
+                        do_action( 'nldcf7_entry_detail_main', $entry );
+                        ?>
                 </div>
 …
                                 </table>
                         </div>
+                <?php
+                /**
+                 * Fires after the sidebar's own cards on the entry detail screen.
+                 *
+                 * Same ownership rules as `nldcf7_entry_detail_main`: the listener
+                 * prints and escapes its own markup. Two hooks exist rather than one
+                 * because an add-on may legitimately need to place content in both
+                 * columns of the same screen.
+                 *
+                 * @since 0.3.0
+                 *
+                 * @param array $entry Entry row, as stored. Passed by value.
+                 */
+                do_action( 'nldcf7_entry_detail_sidebar', $entry );
+                ?>
                 </aside>
         </div>

neutrope-lead-desk-for-contact-form-7/tags/0.3.0/includes/class-entry-repository.php

-              r3666139
+              r3666532
 class NLDCF7_Entry_Repository {
+        /**
+         * Query contexts passed to the query extension hooks.
+         *
+         * The entries screen and the CSV exporter share this repository, so an
+         * add-on constraint that did not say which one it meant would change both.
+         * Listeners check $args['context'] to scope themselves.
+         *
+         * @since 0.3.0
+         */
+        const CONTEXT_LIST    = 'list';
+        const CONTEXT_EXPORT  = 'export';
+        const CONTEXT_DEFAULT = 'default';
         /**
 …
         public function count( array $args = array() ) {
                 global $wpdb;
+                $where   = $this->build_where( $args );
+                $table   = NLDCF7_DB::entries_table();
+                // phpcs:ignore WordPress.DB.PreparedSQL.InterpolatedNotPrepared -- Table name from internal NLDCF7_DB method.
+                $sql      = "SELECT COUNT(*) FROM {$table} {$where['clause']}";
+                $prepared = $where['prepare_args']
+                        ? $wpdb->prepare( $sql, $where['prepare_args'] ) // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared
+                // Same builder as query(). Sharing it is what makes it impossible for a
+                // filtered list to report an unfiltered total: there is one query plan,
+                // not two implementations that have to be kept in step.
+                $parts    = $this->build_query_parts( $args );
+                $table    = NLDCF7_DB::entries_table();
+                $distinct = $parts['distinct'] ? 'DISTINCT ' : '';
+                // phpcs:ignore WordPress.DB.PreparedSQL.InterpolatedNotPrepared -- Table name from internal NLDCF7_DB method; join/clause carry no request values (those are in prepare_args).
+                $sql      = "SELECT COUNT({$distinct}{$table}.id) FROM {$table} {$parts['join']} {$parts['clause']}";
+                $prepared = $parts['prepare_args']
+                        ? $wpdb->prepare( $sql, $parts['prepare_args'] ) // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared
                         : $sql;
                 // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery,WordPress.DB.DirectDatabaseQuery.NoCaching,WordPress.DB.PreparedSQL.NotPrepared,PluginCheck.Security.DirectDB.UnescapedDBParameter -- Internal plugin table, built via build_where() with prepare_args.
+                // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery,WordPress.DB.DirectDatabaseQuery.NoCaching,WordPress.DB.PreparedSQL.NotPrepared,PluginCheck.Security.DirectDB.UnescapedDBParameter -- Internal plugin table, built via build_query_parts() with prepare_args.
                 return (int) $wpdb->get_var( $prepared );
+        }
 …
                 $args = array_merge( $defaults, $args );
                 $where = $this->build_where( $args );
+                $parts = $this->build_query_parts( $args );
                 $orderby = $this->sanitize_orderby( $args['orderby'] );
 …
                 $offset   = ( $page - 1 ) * $per_page;
+                $table = NLDCF7_DB::entries_table();
+                // phpcs:ignore WordPress.DB.PreparedSQL.InterpolatedNotPrepared -- Table / orderby / order are internal allow-listed values; user input is carried in $prepare_args.
+                $sql = "SELECT * FROM {$table} {$where['clause']} ORDER BY {$orderby} {$order} LIMIT %d OFFSET %d";
+                $prepare_args   = $where['prepare_args'];
+                $table    = NLDCF7_DB::entries_table();
+                $distinct = $parts['distinct'] ? 'DISTINCT ' : '';
+                // `{$table}.*` rather than `*`: once an add-on may contribute a JOIN, a
+                // bare `*` would also pull the joined table's columns into the row and
+                // any shared column name (id, created_at) would overwrite ours. With no
+                // join present the two forms select exactly the same thing, so this is
+                // behaviour-preserving when nothing is listening.
+                // phpcs:ignore WordPress.DB.PreparedSQL.InterpolatedNotPrepared -- Table / orderby / order are internal allow-listed values; join/clause carry no request values (those are in prepare_args).
+                $sql = "SELECT {$distinct}{$table}.* FROM {$table} {$parts['join']} {$parts['clause']} ORDER BY {$orderby} {$order} LIMIT %d OFFSET %d";
+                $prepare_args   = $parts['prepare_args'];
                 $prepare_args[] = $per_page;
                 $prepare_args[] = $offset;
 …
+        }
+        /**
+         * Build the complete constraint plan for one query.
+         *
+         * This is the single source of JOIN / WHERE / prepared values / DISTINCT for
+         * BOTH query() and count(). Extending it in one place is what guarantees a
+         * filtered list and its total can never disagree.
+         *
+         * Two extension points run here, in this order:
+         *
+         *   1. `nldcf7_entry_query_args`    -- high level. Adjust the documented
+         *      args (including the long-standing `ids`) without writing SQL.
+         *   2. `nldcf7_entry_query_clauses` -- low level. Contribute a JOIN and
+         *      extra conditions with their values kept separate, for constraints
+         *      that live in another table and should be resolved by the database
+         *      rather than by loading every matching id into PHP.
+         *
+         * @param array $args Query args. `context` identifies the caller.
+         * @return array{join:string,clause:string,prepare_args:array,distinct:bool}
+         */
+        private function build_query_parts( array $args ) {
+                if ( ! isset( $args['context'] ) || ! is_string( $args['context'] ) || '' === $args['context'] ) {
+                        $args['context'] = self::CONTEXT_DEFAULT;
+                }
+                /**
+                 * Filter the entry query args before the SQL is built.
+                 *
+                 * Use this when the constraint can be said with the args the repository
+                 * already understands -- most usefully `ids`, which restricts the query
+                 * to a set of entry IDs. Anything needing a JOIN belongs in
+                 * `nldcf7_entry_query_clauses` instead.
+                 *
+                 * `$args['context']` says who is asking: 'list' for the entries screen,
+                 * 'export' for CSV, 'default' otherwise. Listeners should check it --
+                 * both callers share this repository, so an unconditional constraint
+                 * meant for the list screen would silently change what CSV exports.
+                 *
+                 * @since 0.3.0
+                 *
+                 * @param array $args Query args, including 'context'.
+                 */
+                $filtered = apply_filters( 'nldcf7_entry_query_args', $args );
+                if ( is_array( $filtered ) ) {
+                        $args = $filtered;
+                }
+                $where = $this->build_where( $args );
+                $parts = array(
+                        'join'         => '',
+                        'where'        => array(),
+                        'prepare_args' => array(),
+                        'distinct'     => false,
+                );
+                /**
+                 * Filter the SQL parts for an entry query.
+                 *
+                 * Contribute a JOIN and conditions whose values stay separate from the
+                 * SQL: put `%s` / `%d` placeholders in each `where` entry and the values
+                 * in `prepare_args`, in the same order. Free passes them to
+                 * $wpdb->prepare(). A single pre-built SQL string is deliberately not
+                 * accepted, so request values are never concatenated into a statement.
+                 *
+                 * Set `distinct` when the JOIN can match a row more than once; it is
+                 * applied to the row query and the count together.
+                 *
+                 * Table and column identifiers inside `join` are the listener's own
+                 * responsibility -- Free cannot validate another plugin's schema.
+                 *
+                 * @since 0.3.0
+                 *
+                 * @param array{join:string,where:array,prepare_args:array,distinct:bool} $parts
+                 * @param array $args Query args, including 'context'.
+                 */
+                $contributed = apply_filters( 'nldcf7_entry_query_clauses', $parts, $args );
+                $join         = '';
+                $conditions   = array();
+                $prepare_args = $where['prepare_args'];
+                $distinct     = false;
+                if ( is_array( $contributed ) ) {
+                        $join     = isset( $contributed['join'] ) && is_string( $contributed['join'] ) ? trim( $contributed['join'] ) : '';
+                        $distinct = ! empty( $contributed['distinct'] );
+                        $raw_where = isset( $contributed['where'] ) && is_array( $contributed['where'] ) ? $contributed['where'] : array();
+                        $raw_prep  = isset( $contributed['prepare_args'] ) && is_array( $contributed['prepare_args'] ) ? array_values( $contributed['prepare_args'] ) : array();
+                        foreach ( $raw_where as $condition ) {
+                                if ( is_string( $condition ) && '' !== trim( $condition ) ) {
+                                        $conditions[] = '( ' . trim( $condition ) . ' )';
+                                }
+                        }
+                        // The placeholder count has to match the values supplied, or
+                        // $wpdb->prepare() would mis-bind every value after the mismatch and
+                        // return a broken statement. Rather than run that, drop the whole
+                        // contribution and say so while debugging.
+                        $expected = 0;
+                        foreach ( $conditions as $condition ) {
+                                $expected += preg_match_all( '/%[dfs]/', $condition );
+                        }
+                        if ( $expected !== count( $raw_prep ) ) {
+                                $this->debug_clauses(
+                                        sprintf( 'placeholder/value mismatch (%d placeholders, %d values); clause contribution dropped', $expected, count( $raw_prep ) )
+                                );
+                                $join       = '';
+                                $conditions = array();
+                                $raw_prep   = array();
+                                $distinct   = false;
+                        }
+                        foreach ( $raw_prep as $value ) {
+                                $prepare_args[] = $value;
+                        }
+                }
+                $clause = $where['clause'];
+                if ( $conditions ) {
+                        $extra  = implode( ' AND ', $conditions );
+                        $clause = '' === $clause ? ( 'WHERE ' . $extra ) : ( $clause . ' AND ' . $extra );
+                }
+                return array(
+                        'join'         => $join,
+                        'clause'       => $clause,
+                        'prepare_args' => $prepare_args,
+                        'distinct'     => (bool) $distinct,
+                );
+        }
+        /**
+         * Log a rejected clause contribution while debugging.
+         *
+         * @param string $message
+         * @return void
+         */
+        private function debug_clauses( $message ) {
+                if ( defined( 'WP_DEBUG' ) && WP_DEBUG ) {
+                        // phpcs:ignore WordPress.PHP.DevelopmentFunctions.error_log_error_log -- Gated by WP_DEBUG; a silently dropped clause would otherwise look like a filter that simply did not fire.
+                        error_log( '[neutrope-lead-desk-for-contact-form-7] entry query clauses: ' . $message );
+                }
+        }
         private function sanitize_orderby( $field ) {
                 $allowed = array( 'id', 'submitted_at', 'status', 'form_post_id' );

neutrope-lead-desk-for-contact-form-7/tags/0.3.0/includes/class-export-service.php

-              r3553617
+              r3666532
                                         'orderby'  => 'submitted_at',
                                         'order'    => 'DESC',
+                                        // Tells the query extension hooks this is CSV export, not the
+                                        // entries screen, so a list-only constraint cannot reach it.
+                                        'context'  => NLDCF7_Entry_Repository::CONTEXT_EXPORT,
+                                )
                         );

neutrope-lead-desk-for-contact-form-7/tags/0.3.0/languages/neutrope-lead-desk-for-contact-form-7-ja.po

-              r3666139
+              r3666532
 msgid ""
 msgstr ""
 "Project-Id-Version: Neutrope Lead Desk for Contact Form 7 0.2.0\n"
+"Project-Id-Version: Neutrope Lead Desk for Contact Form 7 0.3.0\n"
 "Report-Msgid-Bugs-To: https://wordpress.org/support/plugin/neutrope-lead-desk-for-contact-form-7\n"
 "Last-Translator: \n"
 …
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
 "POT-Creation-Date: 2026-08-25T14:05:36+00:00\n"
 "PO-Revision-Date: 2026-08-25 00:00+0000\n"
+"POT-Creation-Date: 2026-08-26T04:22:33+00:00\n"
+"PO-Revision-Date: 2026-08-26 00:00+0000\n"
 "Language: ja\n"
 "Plural-Forms: nplurals=1; plural=0;\n"
 …
 msgstr "指定された問い合わせは見つかりませんでした。"
 #: admin/class-entry-list-table.php:211
+#: admin/class-entry-list-table.php:336
 #: admin/views/export.php:43
 msgid "All"
 msgstr "すべて"
 #: admin/class-entry-list-table.php:227
 #: admin/class-entry-list-table.php:361
+#: admin/class-entry-list-table.php:352
+#: admin/class-entry-list-table.php:570
 #: admin/views/export.php:72
 msgid "Trash"
 …
 #: admin/class-entry-event-presenter.php:53
 #: admin/class-entry-list-table.php:238
 #: admin/views/entry-detail.php:253
+#: admin/class-entry-list-table.php:363
+#: admin/views/entry-detail.php:276
 #: includes/class-export-service.php:47
 msgid "Received"
 msgstr "受信日時"
 #: admin/class-entry-list-table.php:239
 #: admin/class-entry-list-table.php:471
 #: admin/views/entry-detail.php:228
+#: admin/class-entry-list-table.php:364
+#: admin/class-entry-list-table.php:680
+#: admin/views/entry-detail.php:251
 #: admin/views/export.php:40
 #: includes/class-export-service.php:48
 …
 msgstr "ステータス"
 #: admin/class-entry-list-table.php:240
 #: admin/class-entry-list-table.php:479
 #: admin/views/entry-detail.php:254
+#: admin/class-entry-list-table.php:365
+#: admin/class-entry-list-table.php:688
+#: admin/views/entry-detail.php:277
 #: admin/views/export.php:51
 #: includes/class-export-service.php:49
 …
 msgstr "フォーム"
 #: admin/class-entry-list-table.php:241
+#: admin/class-entry-list-table.php:366
 #: admin/views/settings.php:73
 #: includes/class-export-service.php:51
 …
 msgstr "名前"
 #: admin/class-entry-list-table.php:242
+#: admin/class-entry-list-table.php:367
 #: admin/views/settings.php:77
 #: includes/class-export-service.php:52
 …
 msgstr "メール"
 #: admin/class-entry-list-table.php:243
+#: admin/class-entry-list-table.php:368
 #: admin/views/settings.php:81
 #: includes/class-export-service.php:53
 …
 msgstr "電話"
 #: admin/class-entry-list-table.php:244
+#: admin/class-entry-list-table.php:369
 msgid "Source"
 msgstr "参照元"
 #: admin/class-entry-list-table.php:245
+#: admin/class-entry-list-table.php:370
 msgid "UTM source"
 msgstr "UTM source"
 #: admin/class-entry-list-table.php:246
 #: admin/views/entry-detail.php:96
+#: admin/class-entry-list-table.php:371
+#: admin/views/entry-detail.php:97
 msgid "Notes"
 msgstr "メモ"
 #: admin/class-entry-list-table.php:264
 #: admin/class-entry-list-table.php:342
+#: admin/class-entry-list-table.php:473
+#: admin/class-entry-list-table.php:551
 msgid "Restore"
 msgstr "復元"
 #: admin/class-entry-list-table.php:269
+#: admin/class-entry-list-table.php:478
 msgid "Set status: New"
 msgstr "ステータス: 未対応"
 #: admin/class-entry-list-table.php:270
+#: admin/class-entry-list-table.php:479
 msgid "Set status: In progress"
 msgstr "ステータス: 対応中"
 #: admin/class-entry-list-table.php:271
+#: admin/class-entry-list-table.php:480
 msgid "Set status: On hold"
 msgstr "ステータス: 保留"
 #: admin/class-entry-list-table.php:272
+#: admin/class-entry-list-table.php:481
 msgid "Set status: Done"
 msgstr "ステータス: 完了"
 #: admin/class-entry-list-table.php:273
+#: admin/class-entry-list-table.php:482
 msgid "Move to trash"
 msgstr "ゴミ箱へ移動"
 #: admin/class-entry-list-table.php:274
+#: admin/class-entry-list-table.php:483
 msgid "Mark as spam"
 msgstr "スパムにする"
 #: admin/class-entry-list-table.php:299
+#: admin/class-entry-list-table.php:508
 msgid "View"
 msgstr "詳細"
 #: admin/class-entry-list-table.php:430
+#: admin/class-entry-list-table.php:639
 msgid "None"
 msgstr "なし"
 #: admin/class-entry-list-table.php:437
+#: admin/class-entry-list-table.php:646
 msgid "No entries are in the trash."
 msgstr "ゴミ箱に問い合わせはありません。"
 #: admin/class-entry-list-table.php:440
+#: admin/class-entry-list-table.php:649
 msgid "No entries match the current filters."
 msgstr "該当する問い合わせはありません。"
 #: admin/class-entry-list-table.php:468
 #: admin/class-entry-list-table.php:469
+#: admin/class-entry-list-table.php:677
+#: admin/class-entry-list-table.php:678
 msgid "Search keywords"
 msgstr "キーワード検索"
 #: admin/class-entry-list-table.php:473
+#: admin/class-entry-list-table.php:682
 msgid "All statuses"
 msgstr "すべてのステータス"
 #: admin/class-entry-list-table.php:481
+#: admin/class-entry-list-table.php:690
 #: admin/views/export.php:54
 msgid "All forms"
 msgstr "すべてのフォーム"
 #: admin/class-entry-list-table.php:487
+#: admin/class-entry-list-table.php:696
 #: admin/views/export.php:32
 msgid "From date"
 msgstr "開始日"
 #: admin/class-entry-list-table.php:489
+#: admin/class-entry-list-table.php:698
 #: admin/views/export.php:36
 msgid "To date"
 msgstr "終了日"
 #: admin/class-entry-list-table.php:494
+#: admin/class-entry-list-table.php:703
 msgid "Show spam"
 msgstr "スパムも表示"
 #: admin/class-entry-list-table.php:497
+#: admin/class-entry-list-table.php:726
 msgid "Filter"
 msgstr "絞り込み"
 #. translators: %d: entry ID
 #: admin/views/entry-detail.php:31
+#: admin/views/entry-detail.php:32
 #, php-format
 msgid "Entry #%d"
 msgstr "問い合わせ #%d"
 #: admin/views/entry-detail.php:34
+#: admin/views/entry-detail.php:35
 msgid "Back to list"
 msgstr "一覧へ戻る"
 #: admin/views/entry-detail.php:47
+#: admin/views/entry-detail.php:48
 msgid "Submitted fields"
 msgstr "送信内容"
 #: admin/views/entry-detail.php:51
+#: admin/views/entry-detail.php:52
 msgid "No submitted fields stored."
 msgstr "送信フィールドが保存されていません。"
 #: admin/views/entry-detail.php:72
+#: admin/views/entry-detail.php:73
 msgid "Attachments (metadata only)"
 msgstr "添付ファイル（メタ情報のみ）"
 #: admin/views/entry-detail.php:76
+#: admin/views/entry-detail.php:77
 msgid "File name"
 msgstr "ファイル名"
 #: admin/views/entry-detail.php:77
+#: admin/views/entry-detail.php:78
 msgid "MIME"
 msgstr "MIME"
 #: admin/views/entry-detail.php:78
+#: admin/views/entry-detail.php:79
 msgid "Size (bytes)"
 msgstr "サイズ (bytes)"
 #: admin/views/entry-detail.php:91
+#: admin/views/entry-detail.php:92
 msgid "Only metadata is captured. The uploaded files themselves are not stored by this plugin."
 msgstr "添付ファイルの実体は保存せず、メタ情報（ファイル名・MIME・サイズ）のみを記録しています。"
 #: admin/views/entry-detail.php:102
+#: admin/views/entry-detail.php:103
 msgid "Note body"
 msgstr "メモ本文"
 #: admin/views/entry-detail.php:105
+#: admin/views/entry-detail.php:106
 msgid "Add note"
 msgstr "メモを追加"
 #: admin/views/entry-detail.php:109
+#: admin/views/entry-detail.php:110
 msgid "No notes yet."
 msgstr "まだメモはありません。"
 #: admin/class-entry-event-presenter.php:119
 #: admin/views/entry-detail.php:115
+#: admin/views/entry-detail.php:116
 msgid "Unknown user"
 msgstr "不明なユーザー"
 #: admin/views/entry-detail.php:238
+#: admin/views/entry-detail.php:261
 msgid "Change status"
 msgstr "ステータスを変更"
 #: admin/views/entry-detail.php:246
+#: admin/views/entry-detail.php:269
 msgid "Update"
 msgstr "更新"
 #: admin/views/entry-detail.php:251
+#: admin/views/entry-detail.php:274
 msgid "Submission info"
 msgstr "送信情報"
 #: admin/views/entry-detail.php:255
+#: admin/views/entry-detail.php:278
 #: includes/class-export-service.php:50
 msgid "Form ID"
 msgstr "フォーム ID"
 #: admin/views/entry-detail.php:256
+#: admin/views/entry-detail.php:279
 #: includes/class-export-service.php:55
 msgid "Submission page URL"
 msgstr "送信ページ URL"
 #: admin/views/entry-detail.php:260
+#: admin/views/entry-detail.php:283
 #: includes/class-export-service.php:56
 msgid "Referrer"
 msgstr "参照元"
 #: admin/views/entry-detail.php:264
+#: admin/views/entry-detail.php:287
 #: includes/class-export-service.php:57
 msgid "Landing URL"
 msgstr "ランディング URL"
 #: admin/views/entry-detail.php:270
+#: admin/views/entry-detail.php:293
 msgid "User Agent"
 msgstr "User Agent"
 #: admin/views/entry-detail.php:271
+#: admin/views/entry-detail.php:294
 #: includes/class-export-service.php:64
 msgid "IP address"
 msgstr "IP アドレス"
 #: admin/views/entry-detail.php:272
+#: admin/views/entry-detail.php:295
 #: includes/class-export-service.php:65
 msgid "Spam flag"
 msgstr "スパム判定"
 #: admin/views/entry-detail.php:272
+#: admin/views/entry-detail.php:295
 #: admin/views/export.php:62
 msgid "Spam"
 msgstr "スパム"
 #: admin/views/entry-detail.php:272
+#: admin/views/entry-detail.php:295
 msgid "Normal"
 msgstr "通常"
 …
 msgstr "設定を保存"
 #: includes/class-entry-repository.php:25
+#: includes/class-entry-repository.php:38
 msgid "New"
 msgstr "未対応"
 #: includes/class-entry-repository.php:26
+#: includes/class-entry-repository.php:39
 msgid "In progress"
 msgstr "対応中"
 #: includes/class-entry-repository.php:27
+#: includes/class-entry-repository.php:40
 msgid "On hold"
 msgstr "保留"
 #: includes/class-entry-repository.php:28
+#: includes/class-entry-repository.php:41
 msgid "Done"
 msgstr "完了"
 …
 msgstr "過去の問い合わせから対応履歴を準備しています。通常どおりご利用いただけます。"
-#. translators: 1: number of records processed, 2: total records, 3: percentage complete
-#: admin/class-admin-menu.php:188
-#, php-format
-msgid "%1$s of %2$s (%3$s%%)"
-msgstr "%2$s 件中 %1$s 件（%3$s%%）"
 #: admin/class-entry-event-presenter.php:54
 msgid "Status changed"
 …
 #: admin/class-entry-event-presenter.php:89
 #: admin/views/entry-detail.php:141
+#: admin/views/entry-detail.php:142
 msgid "Activity"
 msgstr "対応履歴"
 …
 msgstr "メモを見る"
 #: admin/views/entry-detail.php:143
+#: admin/views/entry-detail.php:145
 msgid "History from before this plugin was updated is limited to what could be reconstructed: the time each entry arrived and any notes already saved."
 msgstr "アップデート前の履歴は、受信日時と既存メモから確認できる範囲のみ表示されます。"
 #: admin/views/entry-detail.php:155
+#: admin/views/entry-detail.php:158
 msgid "No activity on this page."
 msgstr "このページに表示する対応履歴はありません。"
 #: admin/views/entry-detail.php:157
+#: admin/views/entry-detail.php:160
 msgid "Back to the latest activity"
 msgstr "最新の対応履歴へ戻る"
 #: admin/views/entry-detail.php:162
+#: admin/views/entry-detail.php:165
 msgid "Preparing activity history…"
 msgstr "対応履歴を準備しています…"
 #: admin/views/entry-detail.php:164
+#: admin/views/entry-detail.php:167
 msgid "No activity recorded yet."
 msgstr "対応履歴はまだありません。"
 #: admin/views/entry-detail.php:198
+#: admin/views/entry-detail.php:201
 msgid "Activity pagination"
 msgstr "対応履歴のページ送り"
 #. translators: 1: current page number, 2: total number of pages
 #: admin/views/entry-detail.php:203
+#: admin/views/entry-detail.php:206
 #, php-format
 msgid "Page %1$s of %2$s"
 msgstr "%2$s ページ中 %1$s ページ"
 #: admin/views/entry-detail.php:211
+#: admin/views/entry-detail.php:214
 msgid "Newer activity"
 msgstr "新しい対応履歴"
 #: admin/views/entry-detail.php:216
+#: admin/views/entry-detail.php:219
 msgid "Older activity"
 msgstr "古い対応履歴"
 …
 msgid "For entries received before this feature was added, activity is limited to the received timestamp and any internal notes already saved. Earlier status, trash, and spam changes were never recorded, so they are not shown."
 msgstr "この機能が追加される前に受信した問い合わせでは、対応履歴は受信日時と保存済みのメモのみとなります。それ以前のステータス・ゴミ箱・スパムの変更は記録されていないため、表示されません。"
+#. translators: 1: number of records processed, 2: total records to process, 3: percentage complete. "Records" counts processing units (entries plus notes), NOT the number of inquiries.
+#: admin/class-admin-menu.php:188
+#, php-format
+msgid "Processed %1$s of %2$s records (%3$s%%)."
+msgstr "%2$s 件の履歴データのうち %1$s 件を処理しました（%3$s%%）。"

neutrope-lead-desk-for-contact-form-7/tags/0.3.0/languages/neutrope-lead-desk-for-contact-form-7.pot

-              r3666139
+              r3666532
 msgid ""
 msgstr ""
 "Project-Id-Version: Neutrope Lead Desk for Contact Form 7 0.2.0\n"
+"Project-Id-Version: Neutrope Lead Desk for Contact Form 7 0.3.0\n"
 "Report-Msgid-Bugs-To: https://wordpress.org/support/plugin/neutrope-lead-desk-for-contact-form-7\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 …
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
 "POT-Creation-Date: 2026-08-25T14:05:36+00:00\n"
+"POT-Creation-Date: 2026-08-26T04:22:33+00:00\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "X-Generator: WP-CLI 2.12.0\n"
 …
 msgstr ""
 #. translators: 1: number of records processed, 2: total records, 3: percentage complete
+#. translators: 1: number of records processed, 2: total records to process, 3: percentage complete. "Records" counts processing units (entries plus notes), NOT the number of inquiries.
 #: admin/class-admin-menu.php:188
 #, php-format
 msgid "%1$s of %2$s (%3$s%%)"
+msgid "Processed %1$s of %2$s records (%3$s%%)."
 msgstr ""
 …
 #: admin/class-entry-event-presenter.php:53
 #: admin/class-entry-list-table.php:238
 #: admin/views/entry-detail.php:253
+#: admin/class-entry-list-table.php:363
+#: admin/views/entry-detail.php:276
 #: includes/class-export-service.php:47
 msgid "Received"
 …
 #: admin/class-entry-event-presenter.php:89
 #: admin/views/entry-detail.php:141
+#: admin/views/entry-detail.php:142
 msgid "Activity"
 msgstr ""
 …
 #: admin/class-entry-event-presenter.php:119
 #: admin/views/entry-detail.php:115
+#: admin/views/entry-detail.php:116
 msgid "Unknown user"
 msgstr ""
 …
 msgstr ""
 #: admin/class-entry-list-table.php:211
+#: admin/class-entry-list-table.php:336
 #: admin/views/export.php:43
 msgid "All"
 msgstr ""
 #: admin/class-entry-list-table.php:227
 #: admin/class-entry-list-table.php:361
+#: admin/class-entry-list-table.php:352
+#: admin/class-entry-list-table.php:570
 #: admin/views/export.php:72
 msgid "Trash"
 msgstr ""
 #: admin/class-entry-list-table.php:239
 #: admin/class-entry-list-table.php:471
 #: admin/views/entry-detail.php:228
+#: admin/class-entry-list-table.php:364
+#: admin/class-entry-list-table.php:680
+#: admin/views/entry-detail.php:251
 #: admin/views/export.php:40
 #: includes/class-export-service.php:48
 …
 msgstr ""
 #: admin/class-entry-list-table.php:240
 #: admin/class-entry-list-table.php:479
 #: admin/views/entry-detail.php:254
+#: admin/class-entry-list-table.php:365
+#: admin/class-entry-list-table.php:688
+#: admin/views/entry-detail.php:277
 #: admin/views/export.php:51
 #: includes/class-export-service.php:49
 …
 msgstr ""
 #: admin/class-entry-list-table.php:241
+#: admin/class-entry-list-table.php:366
 #: admin/views/settings.php:73
 #: includes/class-export-service.php:51
 …
 msgstr ""
 #: admin/class-entry-list-table.php:242
+#: admin/class-entry-list-table.php:367
 #: admin/views/settings.php:77
 #: includes/class-export-service.php:52
 …
 msgstr ""
 #: admin/class-entry-list-table.php:243
+#: admin/class-entry-list-table.php:368
 #: admin/views/settings.php:81
 #: includes/class-export-service.php:53
 …
 msgstr ""
 #: admin/class-entry-list-table.php:244
+#: admin/class-entry-list-table.php:369
 msgid "Source"
 msgstr ""
 #: admin/class-entry-list-table.php:245
+#: admin/class-entry-list-table.php:370
 msgid "UTM source"
 msgstr ""
 #: admin/class-entry-list-table.php:246
 #: admin/views/entry-detail.php:96
+#: admin/class-entry-list-table.php:371
+#: admin/views/entry-detail.php:97
 msgid "Notes"
 msgstr ""
 #: admin/class-entry-list-table.php:264
 #: admin/class-entry-list-table.php:342
+#: admin/class-entry-list-table.php:473
+#: admin/class-entry-list-table.php:551
 msgid "Restore"
 msgstr ""
 #: admin/class-entry-list-table.php:269
+#: admin/class-entry-list-table.php:478
 msgid "Set status: New"
 msgstr ""
 #: admin/class-entry-list-table.php:270
+#: admin/class-entry-list-table.php:479
 msgid "Set status: In progress"
 msgstr ""
 #: admin/class-entry-list-table.php:271
+#: admin/class-entry-list-table.php:480
 msgid "Set status: On hold"
 msgstr ""
 #: admin/class-entry-list-table.php:272
+#: admin/class-entry-list-table.php:481
 msgid "Set status: Done"
 msgstr ""
 #: admin/class-entry-list-table.php:273
+#: admin/class-entry-list-table.php:482
 msgid "Move to trash"
 msgstr ""
 #: admin/class-entry-list-table.php:274
+#: admin/class-entry-list-table.php:483
 msgid "Mark as spam"
 msgstr ""
 #: admin/class-entry-list-table.php:299
+#: admin/class-entry-list-table.php:508
 msgid "View"
 msgstr ""
 #: admin/class-entry-list-table.php:430
+#: admin/class-entry-list-table.php:639
 msgid "None"
 msgstr ""
 #: admin/class-entry-list-table.php:437
+#: admin/class-entry-list-table.php:646
 msgid "No entries are in the trash."
 msgstr ""
 #: admin/class-entry-list-table.php:440
+#: admin/class-entry-list-table.php:649
 msgid "No entries match the current filters."
 msgstr ""
 #: admin/class-entry-list-table.php:468
 #: admin/class-entry-list-table.php:469
+#: admin/class-entry-list-table.php:677
+#: admin/class-entry-list-table.php:678
 msgid "Search keywords"
 msgstr ""
 #: admin/class-entry-list-table.php:473
+#: admin/class-entry-list-table.php:682
 msgid "All statuses"
 msgstr ""
 #: admin/class-entry-list-table.php:481
+#: admin/class-entry-list-table.php:690
 #: admin/views/export.php:54
 msgid "All forms"
 msgstr ""
 #: admin/class-entry-list-table.php:487
+#: admin/class-entry-list-table.php:696
 #: admin/views/export.php:32
 msgid "From date"
 msgstr ""
 #: admin/class-entry-list-table.php:489
+#: admin/class-entry-list-table.php:698
 #: admin/views/export.php:36
 msgid "To date"
 msgstr ""
 #: admin/class-entry-list-table.php:494
+#: admin/class-entry-list-table.php:703
 msgid "Show spam"
 msgstr ""
 #: admin/class-entry-list-table.php:497
+#: admin/class-entry-list-table.php:726
 msgid "Filter"
 msgstr ""
 #. translators: %d: entry ID
 #: admin/views/entry-detail.php:31
+#: admin/views/entry-detail.php:32
 #, php-format
 msgid "Entry #%d"
 msgstr ""
 #: admin/views/entry-detail.php:34
+#: admin/views/entry-detail.php:35
 msgid "Back to list"
 msgstr ""
 #: admin/views/entry-detail.php:47
+#: admin/views/entry-detail.php:48
 msgid "Submitted fields"
 msgstr ""
 #: admin/views/entry-detail.php:51
+#: admin/views/entry-detail.php:52
 msgid "No submitted fields stored."
 msgstr ""
 #: admin/views/entry-detail.php:72
+#: admin/views/entry-detail.php:73
 msgid "Attachments (metadata only)"
 msgstr ""
 #: admin/views/entry-detail.php:76
+#: admin/views/entry-detail.php:77
 msgid "File name"
 msgstr ""
 #: admin/views/entry-detail.php:77
+#: admin/views/entry-detail.php:78
 msgid "MIME"
 msgstr ""
 #: admin/views/entry-detail.php:78
+#: admin/views/entry-detail.php:79
 msgid "Size (bytes)"
 msgstr ""
 #: admin/views/entry-detail.php:91
+#: admin/views/entry-detail.php:92
 msgid "Only metadata is captured. The uploaded files themselves are not stored by this plugin."
 msgstr ""
 #: admin/views/entry-detail.php:102
+#: admin/views/entry-detail.php:103
 msgid "Note body"
 msgstr ""
 #: admin/views/entry-detail.php:105
+#: admin/views/entry-detail.php:106
 msgid "Add note"
 msgstr ""
 #: admin/views/entry-detail.php:109
+#: admin/views/entry-detail.php:110
 msgid "No notes yet."
 msgstr ""
 #: admin/views/entry-detail.php:143
+#: admin/views/entry-detail.php:145
 msgid "History from before this plugin was updated is limited to what could be reconstructed: the time each entry arrived and any notes already saved."
 msgstr ""
 #: admin/views/entry-detail.php:155
+#: admin/views/entry-detail.php:158
 msgid "No activity on this page."
 msgstr ""
 #: admin/views/entry-detail.php:157
+#: admin/views/entry-detail.php:160
 msgid "Back to the latest activity"
 msgstr ""
 #: admin/views/entry-detail.php:162
+#: admin/views/entry-detail.php:165
 msgid "Preparing activity history…"
 msgstr ""
 #: admin/views/entry-detail.php:164
+#: admin/views/entry-detail.php:167
 msgid "No activity recorded yet."
 msgstr ""
 #: admin/views/entry-detail.php:198
+#: admin/views/entry-detail.php:201
 msgid "Activity pagination"
 msgstr ""
 #. translators: 1: current page number, 2: total number of pages
 #: admin/views/entry-detail.php:203
+#: admin/views/entry-detail.php:206
 #, php-format
 msgid "Page %1$s of %2$s"
 msgstr ""
 #: admin/views/entry-detail.php:211
+#: admin/views/entry-detail.php:214
 msgid "Newer activity"
 msgstr ""
 #: admin/views/entry-detail.php:216
+#: admin/views/entry-detail.php:219
 msgid "Older activity"
 msgstr ""
 #: admin/views/entry-detail.php:238
+#: admin/views/entry-detail.php:261
 msgid "Change status"
 msgstr ""
 #: admin/views/entry-detail.php:246
+#: admin/views/entry-detail.php:269
 msgid "Update"
 msgstr ""
 #: admin/views/entry-detail.php:251
+#: admin/views/entry-detail.php:274
 msgid "Submission info"
 msgstr ""
 #: admin/views/entry-detail.php:255
+#: admin/views/entry-detail.php:278
 #: includes/class-export-service.php:50
 msgid "Form ID"
 msgstr ""
 #: admin/views/entry-detail.php:256
+#: admin/views/entry-detail.php:279
 #: includes/class-export-service.php:55
 msgid "Submission page URL"
 msgstr ""
 #: admin/views/entry-detail.php:260
+#: admin/views/entry-detail.php:283
 #: includes/class-export-service.php:56
 msgid "Referrer"
 msgstr ""
 #: admin/views/entry-detail.php:264
+#: admin/views/entry-detail.php:287
 #: includes/class-export-service.php:57
 msgid "Landing URL"
 msgstr ""
 #: admin/views/entry-detail.php:270
+#: admin/views/entry-detail.php:293
 msgid "User Agent"
 msgstr ""
 #: admin/views/entry-detail.php:271
+#: admin/views/entry-detail.php:294
 #: includes/class-export-service.php:64
 msgid "IP address"
 msgstr ""
 #: admin/views/entry-detail.php:272
+#: admin/views/entry-detail.php:295
 #: includes/class-export-service.php:65
 msgid "Spam flag"
 msgstr ""
 #: admin/views/entry-detail.php:272
+#: admin/views/entry-detail.php:295
 #: admin/views/export.php:62
 msgid "Spam"
 msgstr ""
 #: admin/views/entry-detail.php:272
+#: admin/views/entry-detail.php:295
 msgid "Normal"
 msgstr ""
 …
 msgstr ""
 #: includes/class-entry-repository.php:25
+#: includes/class-entry-repository.php:38
 msgid "New"
 msgstr ""
 #: includes/class-entry-repository.php:26
+#: includes/class-entry-repository.php:39
 msgid "In progress"
 msgstr ""
 #: includes/class-entry-repository.php:27
+#: includes/class-entry-repository.php:40
 msgid "On hold"
 msgstr ""
 #: includes/class-entry-repository.php:28
+#: includes/class-entry-repository.php:41
 msgid "Done"
 msgstr ""

neutrope-lead-desk-for-contact-form-7/tags/0.3.0/neutrope-lead-desk-for-contact-form-7.php

-              r3666139
+              r3666532
  * Plugin URI:        https://neutrope.biz/neutrope-lead-desk-for-contact-form-7/
  * Description:       Save Contact Form 7 submissions to the database and manage them as leads in the WordPress admin (list, detail, status, notes, CSV export).
  * Version:           0.2.0
+ * Version:           0.3.0
  * Requires at least: 6.0
  * Requires PHP:      7.4
 …
+}
 define( 'NLDCF7_VERSION', '0.2.0' );
+define( 'NLDCF7_VERSION', '0.3.0' );
 define( 'NLDCF7_DB_VERSION', '1.1.0' );
 define( 'NLDCF7_PLUGIN_FILE', __FILE__ );

neutrope-lead-desk-for-contact-form-7/tags/0.3.0/readme.txt

-              r3666139
+              r3666532
 Tested up to: 7.1
 Requires PHP: 7.4
 Stable tag: 0.2.0
+Stable tag: 0.3.0
 License: GPLv2 or later
 License URI: https://www.gnu.org/licenses/gpl-2.0.html
 …
 The free version is intentionally focused: it saves submissions reliably, gives you an admin list/detail UI, lets you change status, add internal notes, and export to CSV. It does this without pulling in external services, trackers, or upsell banners on unrelated screens.
+Version 0.3.0 is mainly a foundation release for add-ons: it adds documented, generic extension points so other plugins can add columns, filters and detail-screen panels without forking this one. Nothing in the plugin's own behaviour changes because of them, and no database change is involved. See "Extending the plugin" below.
 Since 0.2.0 each entry also keeps an **Activity Timeline** (対応履歴) so you can see what has already been done about an inquiry -- when it arrived, who changed its status and to what, when notes were added, and when it was moved to trash, restored, or marked as spam -- instead of inferring the handling history from the current status alone.
 …
 * Privacy-friendly defaults: IP capture is OFF by default
 * Opt-in data deletion on uninstall (off by default so accidental deletes don't nuke your leads)
+* Extensibility via action/filter hooks: `nldcf7_after_entry_saved`, `nldcf7_after_note_added`, `nldcf7_after_status_changed`, `nldcf7_after_entry_trashed`, `nldcf7_after_entry_restored`, `nldcf7_after_spam_changed`, `nldcf7_entry_data_before_insert`, `nldcf7_export_columns`, `nldcf7_export_row`, `nldcf7_statuses`, `nldcf7_event_render`, `nldcf7_required_capability`
+* Extensibility via action/filter hooks: `nldcf7_after_entry_saved`, `nldcf7_after_note_added`, `nldcf7_after_status_changed`, `nldcf7_after_entry_trashed`, `nldcf7_after_entry_restored`, `nldcf7_after_spam_changed`, `nldcf7_entry_data_before_insert`, `nldcf7_export_columns`, `nldcf7_export_row`, `nldcf7_statuses`, `nldcf7_event_labels`, `nldcf7_event_render`, `nldcf7_required_capability`
+* Since 0.3.0, nine further extension points let an add-on place panels on the entry detail screen, add list columns and filter controls, keep its own filter state across list actions, and constrain the entries query -- all documented under "Extending the plugin"
 **Requirements**
 …
 Please open an issue on the plugin's support forum or the project's issue tracker.
+== Extending the plugin ==
+Version 0.3.0 adds nine extension points for add-on developers. They are
+generic: this plugin knows nothing about what an add-on stores. All of them are
+no-ops when nothing is listening, so a site with no add-on behaves exactly as
+it did in 0.2.0.
+= nldcf7_entry_detail_main =
+Action. Introduced in 0.3.0. Fires on the entry detail screen after this
+plugin's own cards in the main column, before the column closes.
+`do_action( 'nldcf7_entry_detail_main', array $entry )`
+`$entry` is the entry row as stored, passed by value. The listener prints its
+own markup, including its own card wrapper, and is responsible for escaping it.
+Output is not buffered or altered.
+= nldcf7_entry_detail_sidebar =
+Action. Introduced in 0.3.0. The same contract, for the sidebar column. Two
+hooks exist so an add-on can place content in both columns of one screen.
+`do_action( 'nldcf7_entry_detail_sidebar', array $entry )`
+= nldcf7_entry_list_columns =
+Filter. Introduced in 0.3.0. Adds columns to the entries list.
+`apply_filters( 'nldcf7_entry_list_columns', array $columns )`
+Return the column map with your own keys appended; prefix them to avoid
+collisions. Core columns cannot be removed, renamed or repurposed -- every core
+key is restored to its own label after the filter runs, and the checkbox column
+is forced back to the front. Labels are plain text and are escaped on output.
+= nldcf7_entry_list_column_content =
+Filter. Introduced in 0.3.0. Renders a cell for a column you added.
+`apply_filters( 'nldcf7_entry_list_column_content', string $html, string $column_name, array $item )`
+Return HTML for your own column, or the value you were given for anything else.
+Escape your own output; the plugin then passes the result through
+`wp_kses_post()` as a second layer, so ordinary post markup survives while
+scripts and event handlers do not. A non-string return renders an empty cell.
+= nldcf7_entry_list_filters =
+Action. Introduced in 0.3.0. Fires inside the list's existing GET filter form,
+before the Filter button, so a plain select or input submits alongside the
+built-in filters.
+`do_action( 'nldcf7_entry_list_filters', array $current_args )`
+`$current_args` is this plugin's own sanitized filter state, for reference. You
+own your field names, your values and your escaping. No nonce is involved: the
+filter bar only reads.
+= nldcf7_entry_list_carried_args =
+Filter. Introduced in 0.3.0. Keeps your own filter state across the All and
+Trash views, the row actions, and the redirect after a row or bulk action.
+`apply_filters( 'nldcf7_entry_list_carried_args', array $args, array $core )`
+Add your own already-sanitized scalar values. The plugin re-checks the result
+afterwards: reserved keys (`page`, `paged`, `action`, `action2`, `entry_id`,
+`_wpnonce`, `_wp_http_referer`, `view`, `event_page`, `status_view`) are
+stripped, keys are normalised, non-scalars are dropped, and both value length
+and argument count are capped. Core values always win. Do not attempt to
+forward the whole query string.
+= nldcf7_entry_query_args =
+Filter. Introduced in 0.3.0. Adjusts the entries query using arguments the
+repository already understands, without writing SQL.
+`apply_filters( 'nldcf7_entry_query_args', array $args )`
+The most useful is `ids`, an array of entry IDs to restrict the query to.
+`$args['context']` says who is asking: `list` for the entries screen, `export`
+for CSV, `default` otherwise. Check it -- both callers share the same
+repository, so an unconditional constraint would also change what CSV exports.
+= nldcf7_entry_query_clauses =
+Filter. Introduced in 0.3.0. Constrains the entries query using a table of your
+own, resolved by the database rather than by loading matching IDs into PHP.
+`apply_filters( 'nldcf7_entry_query_clauses', array $parts, array $args )`
+`$parts` has four keys:
+* `join` -- a JOIN clause string.
+* `where` -- an array of condition strings, each using `%s` or `%d` placeholders.
+* `prepare_args` -- the values for those placeholders, in order.
+* `distinct` -- boolean, default false.
+Values must go in `prepare_args`, never inside the condition strings; the plugin
+passes them to `$wpdb->prepare()`. A single pre-built SQL string is not
+accepted. If the placeholder count and the value count disagree, the whole
+contribution is discarded. Table and column identifiers inside `join` are your
+responsibility. Set `distinct` when your JOIN can match a row more than once: it
+is applied to the row query and the count together, so the list total and
+pagination stay correct. `$args['context']` applies here too.
+= nldcf7_entry_list_items_prepared =
+Action. Introduced in 0.3.0. Fires once per list page after the rows are known
+and before any cell is rendered.
+`do_action( 'nldcf7_entry_list_items_prepared', array $items )`
+`$items` is the current page's rows only -- never the whole result set. Use it
+to load everything your columns need in one query and keep it in a
+request-local cache, instead of querying once per cell. It is read-only, has no
+return value, and fires with an empty array when the page has no rows. It
+belongs to the entries screen only and never fires during CSV export.
 == Screenshots ==
 …
 == Changelog ==
+= 0.3.0 =
+* Add: generic extension points for the entry detail screen -- `nldcf7_entry_detail_main` and `nldcf7_entry_detail_sidebar` -- so an add-on can place panels in either column without modifying this plugin.
+* Add: generic list extension points -- `nldcf7_entry_list_columns` for columns and `nldcf7_entry_list_column_content` for their cells. Core columns are protected: an add-on cannot remove, rename or repurpose one, and returned cell markup passes through `wp_kses_post()`.
+* Add: `nldcf7_entry_list_filters`, which places an add-on's own controls inside the existing filter bar.
+* Add: `nldcf7_entry_list_carried_args`, so an add-on's own filter stays applied across the All and Trash views and after row and bulk actions. Reserved keys such as nonces, action names and entry IDs are refused, non-scalar values are dropped, and size and count are capped, so a careless listener cannot put unsafe state into a list URL.
+* Add: `nldcf7_entry_query_args` for high-level query constraints, including the existing `ids` argument, and `nldcf7_entry_query_clauses` for constraints that live in an add-on's own table. Clauses are structured -- a JOIN, conditions with placeholders, and their values kept separate -- rather than a raw SQL string, and values always go through `$wpdb->prepare()`.
+* Add: optional `distinct` handling for add-on joins that can match a row more than once. It is applied to the row query and the count together, so the list and its total can never disagree.
+* Add: query context. The entries screen and the CSV exporter share one repository, so each query now says which it is. An add-on constraint meant for the list no longer reaches CSV export unless the add-on opts in.
+* Add: `nldcf7_entry_list_items_prepared`, which hands an add-on the current page's rows once, before any cell is rendered, so custom columns can load their data in a single query instead of one per cell.
+* Fix: the Activity preparation notice counted processing records (entries plus notes) but read as a number of inquiries. It now names the unit; the arithmetic is unchanged.
+* Fix: the "history from before this plugin was updated" note no longer appears on sites that installed this version fresh and therefore have no earlier history to explain.
+* No database change. The schema and database version (1.1.0) are identical to 0.2.0, no migration runs, and existing entries, notes, attachments, activity, settings, capabilities and URLs are untouched. With no add-on installed the plugin behaves exactly as 0.2.0 did.
 = 0.2.0 =
 …
 == Upgrade Notice ==
+= 0.3.0 =
+Adds a documented extension foundation for add-ons, plus two small Activity-history wording fixes. Your leads, notes, activity and database schema are unchanged, and no migration runs. With no add-on installed the plugin behaves exactly as before.
 = 0.2.0 =
 Adds a per-entry activity history. Existing entries have their received time and existing notes reconstructed in the background; status, trash, and spam changes made before this update were never recorded and are not invented. Existing lead data is preserved.

neutrope-lead-desk-for-contact-form-7/trunk/admin/class-admin-menu.php

-              r3666139
+              r3666532
                         $message .= ' ' . esc_html(
                                 sprintf(
                                         /* translators: 1: number of records processed, 2: total records, 3: percentage complete */
                                         __( '%1$s of %2$s (%3$s%%)', 'neutrope-lead-desk-for-contact-form-7' ),
+                                        /* translators: 1: number of records processed, 2: total records to process, 3: percentage complete. "Records" counts processing units (entries plus notes), NOT the number of inquiries. */
+                                        __( 'Processed %1$s of %2$s records (%3$s%%).', 'neutrope-lead-desk-for-contact-form-7' ),
                                         number_format_i18n( (int) $progress['processed'] ),
                                         number_format_i18n( (int) $progress['total'] ),

neutrope-lead-desk-for-contact-form-7/trunk/admin/class-entry-detail-page.php

-              r3666139
+              r3666532
                 $backfill_pending = class_exists( 'NLDCF7_Event_Backfill' ) && NLDCF7_Event_Backfill::is_pending();
+                // The "history from before this plugin was updated" note only makes
+                // sense where there IS such history. The migration snapshot records how
+                // much there was to reconstruct at upgrade time: both totals are zero on
+                // a site that installed this version fresh, and the note is then simply
+                // untrue. The snapshot is used rather than today's entry count because
+                // entries received since the upgrade say nothing about what came before.
+                //
+                // If the snapshot is missing or unreadable the note is shown: an
+                // unnecessary explanation is a smaller harm than silently omitting the
+                // one that tells an admin why their older entries look sparse.
+                $show_history_note = true;
+                if ( class_exists( 'NLDCF7_Event_Backfill' ) && NLDCF7_Event_Backfill::is_initialised() ) {
+                        $backfill_state = NLDCF7_Event_Backfill::get_state();
+                        if ( isset( $backfill_state['entry_total'], $backfill_state['note_total'] ) ) {
+                                $show_history_note = ( (int) $backfill_state['entry_total'] > 0 )
+                                        || ( (int) $backfill_state['note_total'] > 0 );
+                        }
+                }
                 if ( $this->event_repo ) {
                         $events_total       = $this->event_repo->count_for_entry( (int) $entry['id'] );

neutrope-lead-desk-for-contact-form-7/trunk/admin/class-entry-list-table.php

-              r3666139
+              r3666532
+                }
+                return $args;
+                return self::apply_carried_args_filter( $args );
+        }
+        /**
+         * Maximum number of add-on contributed args carried in a list URL.
+         */
+        const CARRIED_MAX_ARGS = 20;
+        /**
+         * Maximum length of a single carried value, in characters.
+         */
+        const CARRIED_MAX_VALUE = 200;
+        /**
+         * Query keys an add-on may never contribute to a carried list URL.
+         *
+         * `page` is here because Free sets it itself; `paged` because v0.2.0
+         * deliberately returns to the first page after an action; the rest are
+         * mutation, authentication or routing state that must never be replayed
+         * from a link the admin can bookmark or share.
+         *
+         * @var string[]
+         */
+        private static $carried_denylist = array(
+                'page',
+                'paged',
+                'action',
+                'action2',
+                'entry_id',
+                '_wpnonce',
+                '_wp_http_referer',
+                'view',
+                'event_page',
+                self::VIEW_QUERY_VAR,
+        );
+        /**
+         * Let add-ons contribute their own filter state, then re-impose Free's rules.
+         *
+         * Everything an add-on adds is treated as untrusted: the deny-list, key
+         * normalisation, scalar-only rule and size caps are applied AFTER the
+         * filter, so a careless listener cannot put `_wpnonce` or an array back
+         * into a URL. Core args are re-applied last and always win.
+         *
+         * This is the one place custom filter state enters a list URL. Every path
+         * that needs it -- the All/Trash views, the row actions, and the redirect
+         * after a row or bulk action -- reaches it through current_filter_args(),
+         * so there is a single implementation rather than one per call site.
+         *
+         * @param array<string,string|int> $core Sanitized core filter args.
+         * @return array<string,string|int>
+         */
+        private static function apply_carried_args_filter( array $core ) {
+                /**
+                 * Filter the list state carried across view switches and row/bulk actions.
+                 *
+                 * Add-ons append their own already-sanitized scalar args. Free re-checks
+                 * the result regardless; see the class constants for the size caps and
+                 * `$carried_denylist` for the keys that are always stripped.
+                 *
+                 * Free never forwards the raw query string, so an add-on filter that
+                 * adds nothing leaves the URL byte-identical to v0.2.0.
+                 *
+                 * @since 0.3.0
+                 *
+                 * @param array<string,string|int> $args Args to carry. Core keys included.
+                 * @param array<string,string|int> $core The core args, for reference.
+                 */
+                $filtered = apply_filters( 'nldcf7_entry_list_carried_args', $core, $core );
+                if ( ! is_array( $filtered ) ) {
+                        return $core;
+                }
+                $extra = array();
+                foreach ( $filtered as $key => $value ) {
+                        if ( count( $extra ) >= self::CARRIED_MAX_ARGS ) {
+                                self::debug_carried( 'too many carried args; extra dropped' );
+                                break;
+                        }
+                        $key = sanitize_key( (string) $key );
+                        if ( '' === $key || array_key_exists( $key, $core ) ) {
+                                // Empty/unusable key, or a core key -- core is authoritative and
+                                // is re-applied below either way.
+                                continue;
+                        }
+                        if ( in_array( $key, self::$carried_denylist, true ) ) {
+                                self::debug_carried( 'reserved key refused: ' . $key );
+                                continue;
+                        }
+                        if ( ! is_scalar( $value ) ) {
+                                // Arrays and objects are dropped outright. Casting one would
+                                // print the literal string "Array" into a URL.
+                                self::debug_carried( 'non-scalar value dropped for key: ' . $key );
+                                continue;
+                        }
+                        $value = (string) $value;
+                        if ( '' === $value ) {
+                                continue;
+                        }
+                        if ( function_exists( 'mb_substr' ) ) {
+                                $value = mb_substr( $value, 0, self::CARRIED_MAX_VALUE );
+                        } else {
+                                $value = substr( $value, 0, self::CARRIED_MAX_VALUE );
+                        }
+                        $extra[ $key ] = sanitize_text_field( $value );
+                }
+                // Core last: an add-on cannot override the screen's own filter state.
+                return array_merge( $extra, $core );
+        }
+        /**
+         * Log a rejected carried-arg contribution while debugging.
+         *
+         * @param string $message
+         * @return void
+         */
+        private static function debug_carried( $message ) {
+                if ( defined( 'WP_DEBUG' ) && WP_DEBUG ) {
+                        // phpcs:ignore WordPress.PHP.DevelopmentFunctions.error_log_error_log -- Gated by WP_DEBUG; an add-on silently losing filter state is otherwise very hard to diagnose.
+                        error_log( '[neutrope-lead-desk-for-contact-form-7] carried args: ' . $message );
+                }
+        }
 …
         public function get_columns() {
                 return array(
+                $core = array(
                         'cb'                => '<input type="checkbox" />',
                         'submitted_at'      => __( 'Received', 'neutrope-lead-desk-for-contact-form-7' ),
 …
                         'note_count'        => __( 'Notes', 'neutrope-lead-desk-for-contact-form-7' ),
                 );
+                /**
+                 * Filter the entries list columns.
+                 *
+                 * Add-ons may append their own columns. They may NOT remove, rename or
+                 * repurpose a core column: every core key is restored to its own label
+                 * after this filter runs, so reusing one silently changes nothing. That
+                 * is enforced in code rather than left to convention, because a column
+                 * whose header says one thing and whose cells say another is a data
+                 * integrity problem, not a styling preference.
+                 *
+                 * Cells for added columns are rendered through
+                 * `nldcf7_entry_list_column_content`.
+                 *
+                 * @since 0.3.0
+                 *
+                 * @param array<string,string> $columns column key => header label.
+                 */
+                $filtered = apply_filters( 'nldcf7_entry_list_columns', $core );
+                if ( ! is_array( $filtered ) ) {
+                        return $core;
+                }
+                // Keep only usable entries: a non-empty sanitize_key()-able key mapped
+                // to a scalar label. Anything else is a malformed contribution and is
+                // dropped rather than being allowed to break the header row.
+                $clean = array();
+                foreach ( $filtered as $key => $label ) {
+                        $key = sanitize_key( (string) $key );
+                        if ( '' === $key || ! is_scalar( $label ) ) {
+                                continue;
+                        }
+                        $clean[ $key ] = (string) $label;
+                }
+                // Core wins: restore every core column's own label, and re-add any the
+                // filter dropped. `cb` goes back to the front so the bulk-select box
+                // never ends up mid-row.
+                foreach ( $core as $key => $label ) {
+                        $clean[ $key ] = $label;
+                }
+                if ( isset( $clean['cb'] ) ) {
+                        $cb = $clean['cb'];
+                        unset( $clean['cb'] );
+                        $clean = array_merge( array( 'cb' => $cb ), $clean );
+                }
+                return $clean;
+        }
+        /**
+         * Render a cell for a column this class has no `column_{key}()` method for.
+         *
+         * Only add-on columns reach here: every core column has its own method.
+         * WordPress core's own `column_default()` is an empty no-op, so without
+         * this an added column would render as a blank cell.
+         *
+         * The listener returns HTML and is responsible for escaping it; Free then
+         * runs the result through `wp_kses_post()` as a second layer, which is the
+         * reason this is a filter with a return value rather than an action that
+         * echoes -- output that Free never sees is output Free cannot make safe.
+         *
+         * @param array  $item        Entry row.
+         * @param string $column_name Column key.
+         * @return string Escaped HTML, or '' when nothing is contributed.
+         */
+        public function column_default( $item, $column_name ) {
+                /**
+                 * Filter the cell content for an add-on column on the entries list.
+                 *
+                 * @since 0.3.0
+                 *
+                 * @param string $html        Cell HTML. Default ''.
+                 * @param string $column_name Column key being rendered.
+                 * @param array  $item        Entry row, as stored.
+                 */
+                $html = apply_filters( 'nldcf7_entry_list_column_content', '', (string) $column_name, $item );
+                if ( ! is_string( $html ) || '' === $html ) {
+                        return '';
+                }
+                return wp_kses_post( $html );
+        }
 …
                         </label>
+                        <?php submit_button( __( 'Filter', 'neutrope-lead-desk-for-contact-form-7' ), '', 'nldcf7-filter-submit', false ); ?>
+                        <?php
+                        /**
+                         * Fires inside the entries list filter bar, before the Filter button.
+                         *
+                         * Listeners print their own form controls here. The position is
+                         * guaranteed to be inside the existing GET form, so a plain
+                         * `<select>` or `<input>` submits with the core filters and needs
+                         * nothing else wired up.
+                         *
+                         * No nonce is involved: this bar only reads, and Free's own filters
+                         * carry none either. The listener owns its field names, its values
+                         * and its escaping; Free owns only the placement.
+                         *
+                         * @since 0.3.0
+                         *
+                         * @param array<string,string|int> $current_args Sanitized core filter
+                         *                                               state for this request.
+                         */
+                        do_action( 'nldcf7_entry_list_filters', self::current_filter_args() );
+                        submit_button( __( 'Filter', 'neutrope-lead-desk-for-contact-form-7' ), '', 'nldcf7-filter-submit', false );
+                        ?>
                 </div>
                 <?php
 …
                         // behaving as a soft delete rather than turning into a filter.
                         'trashed_only' => ( self::VIEW_TRASH === self::current_view() ),
+                        // Identifies this caller to the query extension hooks so an add-on
+                        // can constrain the list without also constraining CSV export.
+                        'context'      => NLDCF7_Entry_Repository::CONTEXT_LIST,
                 );
 …
+                        )
                 );
+                /**
+                 * Fires once the rows for the current list page are known.
+                 *
+                 * Add-ons that render their own columns use this to load whatever they
+                 * need for these rows in one query, before any cell is rendered.
+                 * Without it they are pushed into N+1: the cell filter is handed a
+                 * single row and has no way to learn what else is on the page, so the
+                 * only alternative is a lookup per cell -- twenty rows with two custom
+                 * columns being up to forty extra queries.
+                 *
+                 * Free's own note-count cache above is the same pattern; this is that
+                 * opportunity handed to extensions.
+                 *
+                 * Contract:
+                 *   - $items is THIS PAGE's rows, never the whole result set.
+                 *   - Read-only. Listeners must not mutate the list's state, and no
+                 *     return value is used.
+                 *   - Fires exactly once per prepare cycle, including with an empty
+                 *     array when the page has no rows, so "once per cycle" holds
+                 *     without a special case for empty results.
+                 *   - The entries screen only. CSV export does not build a list table
+                 *     and so never reaches here.
+                 *   - Running the secondary query safely -- preparing it, checking
+                 *     capabilities -- belongs to the listener.
+                 *
+                 * Fired after this class has finished its own preparation so that a
+                 * listener cannot interleave with it. The repository, the controller
+                 * and this table instance are deliberately not passed.
+                 *
+                 * @since 0.3.0
+                 *
+                 * @param array<int,array<string,mixed>> $items Rows on the current page.
+                 */
+                do_action( 'nldcf7_entry_list_items_prepared', $this->items );
+        }

neutrope-lead-desk-for-contact-form-7/trunk/admin/views/entry-detail.php

-              r3666139
+              r3666532
  *   $notice   array|null  Flash notice ['message'=>string,'type'=>string]
  *                         pulled from per-user transient (consume_notice()).
+ *   $show_history_note bool Whether the pre-upgrade history caveat applies.
+ *
  * phpcs:disable WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedVariableFound -- Locals in an included view, not actual globals.
 …
                         <div class="nldcf7-card nldcf7-timeline-card">
                                 <h2><?php esc_html_e( 'Activity', 'neutrope-lead-desk-for-contact-form-7' ); ?></h2>
+                                <p class="description">
+                                        <?php esc_html_e( 'History from before this plugin was updated is limited to what could be reconstructed: the time each entry arrived and any notes already saved.', 'neutrope-lead-desk-for-contact-form-7' ); ?>
+                                </p>
+                                <?php if ( $show_history_note ) : ?>
+                                        <p class="description">
+                                                <?php esc_html_e( 'History from before this plugin was updated is limited to what could be reconstructed: the time each entry arrived and any notes already saved.', 'neutrope-lead-desk-for-contact-form-7' ); ?>
+                                        </p>
+                                <?php endif; ?>
                                 <?php if ( empty( $events ) ) : ?>
 …
                         </div>
+                        <?php
+                        /**
+                         * Fires after the main column's own cards on the entry detail screen.
+                         *
+                         * Add-ons print their own markup here -- including the surrounding
+                         * `<div class="nldcf7-card">` -- and own escaping it. Nothing is
+                         * buffered or filtered on the way out, so a listener that prints
+                         * nothing costs nothing and leaves the page byte-identical.
+                         *
+                         * The position is deliberately "after every core card" rather than
+                         * between two of them: card order is an internal detail that may
+                         * change, and a between-cards contract could not be kept stable.
+                         *
+                         * @since 0.3.0
+                         *
+                         * @param array $entry Entry row, as stored. Passed by value.
+                         */
+                        do_action( 'nldcf7_entry_detail_main', $entry );
+                        ?>
                 </div>
 …
                                 </table>
                         </div>
+                <?php
+                /**
+                 * Fires after the sidebar's own cards on the entry detail screen.
+                 *
+                 * Same ownership rules as `nldcf7_entry_detail_main`: the listener
+                 * prints and escapes its own markup. Two hooks exist rather than one
+                 * because an add-on may legitimately need to place content in both
+                 * columns of the same screen.
+                 *
+                 * @since 0.3.0
+                 *
+                 * @param array $entry Entry row, as stored. Passed by value.
+                 */
+                do_action( 'nldcf7_entry_detail_sidebar', $entry );
+                ?>
                 </aside>
         </div>

neutrope-lead-desk-for-contact-form-7/trunk/includes/class-entry-repository.php

-              r3666139
+              r3666532
 class NLDCF7_Entry_Repository {
+        /**
+         * Query contexts passed to the query extension hooks.
+         *
+         * The entries screen and the CSV exporter share this repository, so an
+         * add-on constraint that did not say which one it meant would change both.
+         * Listeners check $args['context'] to scope themselves.
+         *
+         * @since 0.3.0
+         */
+        const CONTEXT_LIST    = 'list';
+        const CONTEXT_EXPORT  = 'export';
+        const CONTEXT_DEFAULT = 'default';
         /**
 …
         public function count( array $args = array() ) {
                 global $wpdb;
+                $where   = $this->build_where( $args );
+                $table   = NLDCF7_DB::entries_table();
+                // phpcs:ignore WordPress.DB.PreparedSQL.InterpolatedNotPrepared -- Table name from internal NLDCF7_DB method.
+                $sql      = "SELECT COUNT(*) FROM {$table} {$where['clause']}";
+                $prepared = $where['prepare_args']
+                        ? $wpdb->prepare( $sql, $where['prepare_args'] ) // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared
+                // Same builder as query(). Sharing it is what makes it impossible for a
+                // filtered list to report an unfiltered total: there is one query plan,
+                // not two implementations that have to be kept in step.
+                $parts    = $this->build_query_parts( $args );
+                $table    = NLDCF7_DB::entries_table();
+                $distinct = $parts['distinct'] ? 'DISTINCT ' : '';
+                // phpcs:ignore WordPress.DB.PreparedSQL.InterpolatedNotPrepared -- Table name from internal NLDCF7_DB method; join/clause carry no request values (those are in prepare_args).
+                $sql      = "SELECT COUNT({$distinct}{$table}.id) FROM {$table} {$parts['join']} {$parts['clause']}";
+                $prepared = $parts['prepare_args']
+                        ? $wpdb->prepare( $sql, $parts['prepare_args'] ) // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared
                         : $sql;
                 // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery,WordPress.DB.DirectDatabaseQuery.NoCaching,WordPress.DB.PreparedSQL.NotPrepared,PluginCheck.Security.DirectDB.UnescapedDBParameter -- Internal plugin table, built via build_where() with prepare_args.
+                // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery,WordPress.DB.DirectDatabaseQuery.NoCaching,WordPress.DB.PreparedSQL.NotPrepared,PluginCheck.Security.DirectDB.UnescapedDBParameter -- Internal plugin table, built via build_query_parts() with prepare_args.
                 return (int) $wpdb->get_var( $prepared );
+        }
 …
                 $args = array_merge( $defaults, $args );
                 $where = $this->build_where( $args );
+                $parts = $this->build_query_parts( $args );
                 $orderby = $this->sanitize_orderby( $args['orderby'] );
 …
                 $offset   = ( $page - 1 ) * $per_page;
+                $table = NLDCF7_DB::entries_table();
+                // phpcs:ignore WordPress.DB.PreparedSQL.InterpolatedNotPrepared -- Table / orderby / order are internal allow-listed values; user input is carried in $prepare_args.
+                $sql = "SELECT * FROM {$table} {$where['clause']} ORDER BY {$orderby} {$order} LIMIT %d OFFSET %d";
+                $prepare_args   = $where['prepare_args'];
+                $table    = NLDCF7_DB::entries_table();
+                $distinct = $parts['distinct'] ? 'DISTINCT ' : '';
+                // `{$table}.*` rather than `*`: once an add-on may contribute a JOIN, a
+                // bare `*` would also pull the joined table's columns into the row and
+                // any shared column name (id, created_at) would overwrite ours. With no
+                // join present the two forms select exactly the same thing, so this is
+                // behaviour-preserving when nothing is listening.
+                // phpcs:ignore WordPress.DB.PreparedSQL.InterpolatedNotPrepared -- Table / orderby / order are internal allow-listed values; join/clause carry no request values (those are in prepare_args).
+                $sql = "SELECT {$distinct}{$table}.* FROM {$table} {$parts['join']} {$parts['clause']} ORDER BY {$orderby} {$order} LIMIT %d OFFSET %d";
+                $prepare_args   = $parts['prepare_args'];
                 $prepare_args[] = $per_page;
                 $prepare_args[] = $offset;
 …
+        }
+        /**
+         * Build the complete constraint plan for one query.
+         *
+         * This is the single source of JOIN / WHERE / prepared values / DISTINCT for
+         * BOTH query() and count(). Extending it in one place is what guarantees a
+         * filtered list and its total can never disagree.
+         *
+         * Two extension points run here, in this order:
+         *
+         *   1. `nldcf7_entry_query_args`    -- high level. Adjust the documented
+         *      args (including the long-standing `ids`) without writing SQL.
+         *   2. `nldcf7_entry_query_clauses` -- low level. Contribute a JOIN and
+         *      extra conditions with their values kept separate, for constraints
+         *      that live in another table and should be resolved by the database
+         *      rather than by loading every matching id into PHP.
+         *
+         * @param array $args Query args. `context` identifies the caller.
+         * @return array{join:string,clause:string,prepare_args:array,distinct:bool}
+         */
+        private function build_query_parts( array $args ) {
+                if ( ! isset( $args['context'] ) || ! is_string( $args['context'] ) || '' === $args['context'] ) {
+                        $args['context'] = self::CONTEXT_DEFAULT;
+                }
+                /**
+                 * Filter the entry query args before the SQL is built.
+                 *
+                 * Use this when the constraint can be said with the args the repository
+                 * already understands -- most usefully `ids`, which restricts the query
+                 * to a set of entry IDs. Anything needing a JOIN belongs in
+                 * `nldcf7_entry_query_clauses` instead.
+                 *
+                 * `$args['context']` says who is asking: 'list' for the entries screen,
+                 * 'export' for CSV, 'default' otherwise. Listeners should check it --
+                 * both callers share this repository, so an unconditional constraint
+                 * meant for the list screen would silently change what CSV exports.
+                 *
+                 * @since 0.3.0
+                 *
+                 * @param array $args Query args, including 'context'.
+                 */
+                $filtered = apply_filters( 'nldcf7_entry_query_args', $args );
+                if ( is_array( $filtered ) ) {
+                        $args = $filtered;
+                }
+                $where = $this->build_where( $args );
+                $parts = array(
+                        'join'         => '',
+                        'where'        => array(),
+                        'prepare_args' => array(),
+                        'distinct'     => false,
+                );
+                /**
+                 * Filter the SQL parts for an entry query.
+                 *
+                 * Contribute a JOIN and conditions whose values stay separate from the
+                 * SQL: put `%s` / `%d` placeholders in each `where` entry and the values
+                 * in `prepare_args`, in the same order. Free passes them to
+                 * $wpdb->prepare(). A single pre-built SQL string is deliberately not
+                 * accepted, so request values are never concatenated into a statement.
+                 *
+                 * Set `distinct` when the JOIN can match a row more than once; it is
+                 * applied to the row query and the count together.
+                 *
+                 * Table and column identifiers inside `join` are the listener's own
+                 * responsibility -- Free cannot validate another plugin's schema.
+                 *
+                 * @since 0.3.0
+                 *
+                 * @param array{join:string,where:array,prepare_args:array,distinct:bool} $parts
+                 * @param array $args Query args, including 'context'.
+                 */
+                $contributed = apply_filters( 'nldcf7_entry_query_clauses', $parts, $args );
+                $join         = '';
+                $conditions   = array();
+                $prepare_args = $where['prepare_args'];
+                $distinct     = false;
+                if ( is_array( $contributed ) ) {
+                        $join     = isset( $contributed['join'] ) && is_string( $contributed['join'] ) ? trim( $contributed['join'] ) : '';
+                        $distinct = ! empty( $contributed['distinct'] );
+                        $raw_where = isset( $contributed['where'] ) && is_array( $contributed['where'] ) ? $contributed['where'] : array();
+                        $raw_prep  = isset( $contributed['prepare_args'] ) && is_array( $contributed['prepare_args'] ) ? array_values( $contributed['prepare_args'] ) : array();
+                        foreach ( $raw_where as $condition ) {
+                                if ( is_string( $condition ) && '' !== trim( $condition ) ) {
+                                        $conditions[] = '( ' . trim( $condition ) . ' )';
+                                }
+                        }
+                        // The placeholder count has to match the values supplied, or
+                        // $wpdb->prepare() would mis-bind every value after the mismatch and
+                        // return a broken statement. Rather than run that, drop the whole
+                        // contribution and say so while debugging.
+                        $expected = 0;
+                        foreach ( $conditions as $condition ) {
+                                $expected += preg_match_all( '/%[dfs]/', $condition );
+                        }
+                        if ( $expected !== count( $raw_prep ) ) {
+                                $this->debug_clauses(
+                                        sprintf( 'placeholder/value mismatch (%d placeholders, %d values); clause contribution dropped', $expected, count( $raw_prep ) )
+                                );
+                                $join       = '';
+                                $conditions = array();
+                                $raw_prep   = array();
+                                $distinct   = false;
+                        }
+                        foreach ( $raw_prep as $value ) {
+                                $prepare_args[] = $value;
+                        }
+                }
+                $clause = $where['clause'];
+                if ( $conditions ) {
+                        $extra  = implode( ' AND ', $conditions );
+                        $clause = '' === $clause ? ( 'WHERE ' . $extra ) : ( $clause . ' AND ' . $extra );
+                }
+                return array(
+                        'join'         => $join,
+                        'clause'       => $clause,
+                        'prepare_args' => $prepare_args,
+                        'distinct'     => (bool) $distinct,
+                );
+        }
+        /**
+         * Log a rejected clause contribution while debugging.
+         *
+         * @param string $message
+         * @return void
+         */
+        private function debug_clauses( $message ) {
+                if ( defined( 'WP_DEBUG' ) && WP_DEBUG ) {
+                        // phpcs:ignore WordPress.PHP.DevelopmentFunctions.error_log_error_log -- Gated by WP_DEBUG; a silently dropped clause would otherwise look like a filter that simply did not fire.
+                        error_log( '[neutrope-lead-desk-for-contact-form-7] entry query clauses: ' . $message );
+                }
+        }
         private function sanitize_orderby( $field ) {
                 $allowed = array( 'id', 'submitted_at', 'status', 'form_post_id' );

neutrope-lead-desk-for-contact-form-7/trunk/includes/class-export-service.php

-              r3553617
+              r3666532
                                         'orderby'  => 'submitted_at',
                                         'order'    => 'DESC',
+                                        // Tells the query extension hooks this is CSV export, not the
+                                        // entries screen, so a list-only constraint cannot reach it.
+                                        'context'  => NLDCF7_Entry_Repository::CONTEXT_EXPORT,
+                                )
                         );

neutrope-lead-desk-for-contact-form-7/trunk/languages/neutrope-lead-desk-for-contact-form-7-ja.po

-              r3666139
+              r3666532
 msgid ""
 msgstr ""
 "Project-Id-Version: Neutrope Lead Desk for Contact Form 7 0.2.0\n"
+"Project-Id-Version: Neutrope Lead Desk for Contact Form 7 0.3.0\n"
 "Report-Msgid-Bugs-To: https://wordpress.org/support/plugin/neutrope-lead-desk-for-contact-form-7\n"
 "Last-Translator: \n"
 …
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
 "POT-Creation-Date: 2026-08-25T14:05:36+00:00\n"
 "PO-Revision-Date: 2026-08-25 00:00+0000\n"
+"POT-Creation-Date: 2026-08-26T04:22:33+00:00\n"
+"PO-Revision-Date: 2026-08-26 00:00+0000\n"
 "Language: ja\n"
 "Plural-Forms: nplurals=1; plural=0;\n"
 …
 msgstr "指定された問い合わせは見つかりませんでした。"
 #: admin/class-entry-list-table.php:211
+#: admin/class-entry-list-table.php:336
 #: admin/views/export.php:43
 msgid "All"
 msgstr "すべて"
 #: admin/class-entry-list-table.php:227
 #: admin/class-entry-list-table.php:361
+#: admin/class-entry-list-table.php:352
+#: admin/class-entry-list-table.php:570
 #: admin/views/export.php:72
 msgid "Trash"
 …
 #: admin/class-entry-event-presenter.php:53
 #: admin/class-entry-list-table.php:238
 #: admin/views/entry-detail.php:253
+#: admin/class-entry-list-table.php:363
+#: admin/views/entry-detail.php:276
 #: includes/class-export-service.php:47
 msgid "Received"
 msgstr "受信日時"
 #: admin/class-entry-list-table.php:239
 #: admin/class-entry-list-table.php:471
 #: admin/views/entry-detail.php:228
+#: admin/class-entry-list-table.php:364
+#: admin/class-entry-list-table.php:680
+#: admin/views/entry-detail.php:251
 #: admin/views/export.php:40
 #: includes/class-export-service.php:48
 …
 msgstr "ステータス"
 #: admin/class-entry-list-table.php:240
 #: admin/class-entry-list-table.php:479
 #: admin/views/entry-detail.php:254
+#: admin/class-entry-list-table.php:365
+#: admin/class-entry-list-table.php:688
+#: admin/views/entry-detail.php:277
 #: admin/views/export.php:51
 #: includes/class-export-service.php:49
 …
 msgstr "フォーム"
 #: admin/class-entry-list-table.php:241
+#: admin/class-entry-list-table.php:366
 #: admin/views/settings.php:73
 #: includes/class-export-service.php:51
 …
 msgstr "名前"
 #: admin/class-entry-list-table.php:242
+#: admin/class-entry-list-table.php:367
 #: admin/views/settings.php:77
 #: includes/class-export-service.php:52
 …
 msgstr "メール"
 #: admin/class-entry-list-table.php:243
+#: admin/class-entry-list-table.php:368
 #: admin/views/settings.php:81
 #: includes/class-export-service.php:53
 …
 msgstr "電話"
 #: admin/class-entry-list-table.php:244
+#: admin/class-entry-list-table.php:369
 msgid "Source"
 msgstr "参照元"
 #: admin/class-entry-list-table.php:245
+#: admin/class-entry-list-table.php:370
 msgid "UTM source"
 msgstr "UTM source"
 #: admin/class-entry-list-table.php:246
 #: admin/views/entry-detail.php:96
+#: admin/class-entry-list-table.php:371
+#: admin/views/entry-detail.php:97
 msgid "Notes"
 msgstr "メモ"
 #: admin/class-entry-list-table.php:264
 #: admin/class-entry-list-table.php:342
+#: admin/class-entry-list-table.php:473
+#: admin/class-entry-list-table.php:551
 msgid "Restore"
 msgstr "復元"
 #: admin/class-entry-list-table.php:269
+#: admin/class-entry-list-table.php:478
 msgid "Set status: New"
 msgstr "ステータス: 未対応"
 #: admin/class-entry-list-table.php:270
+#: admin/class-entry-list-table.php:479
 msgid "Set status: In progress"
 msgstr "ステータス: 対応中"
 #: admin/class-entry-list-table.php:271
+#: admin/class-entry-list-table.php:480
 msgid "Set status: On hold"
 msgstr "ステータス: 保留"
 #: admin/class-entry-list-table.php:272
+#: admin/class-entry-list-table.php:481
 msgid "Set status: Done"
 msgstr "ステータス: 完了"
 #: admin/class-entry-list-table.php:273
+#: admin/class-entry-list-table.php:482
 msgid "Move to trash"
 msgstr "ゴミ箱へ移動"
 #: admin/class-entry-list-table.php:274
+#: admin/class-entry-list-table.php:483
 msgid "Mark as spam"
 msgstr "スパムにする"
 #: admin/class-entry-list-table.php:299
+#: admin/class-entry-list-table.php:508
 msgid "View"
 msgstr "詳細"
 #: admin/class-entry-list-table.php:430
+#: admin/class-entry-list-table.php:639
 msgid "None"
 msgstr "なし"
 #: admin/class-entry-list-table.php:437
+#: admin/class-entry-list-table.php:646
 msgid "No entries are in the trash."
 msgstr "ゴミ箱に問い合わせはありません。"
 #: admin/class-entry-list-table.php:440
+#: admin/class-entry-list-table.php:649
 msgid "No entries match the current filters."
 msgstr "該当する問い合わせはありません。"
 #: admin/class-entry-list-table.php:468
 #: admin/class-entry-list-table.php:469
+#: admin/class-entry-list-table.php:677
+#: admin/class-entry-list-table.php:678
 msgid "Search keywords"
 msgstr "キーワード検索"
 #: admin/class-entry-list-table.php:473
+#: admin/class-entry-list-table.php:682
 msgid "All statuses"
 msgstr "すべてのステータス"
 #: admin/class-entry-list-table.php:481
+#: admin/class-entry-list-table.php:690
 #: admin/views/export.php:54
 msgid "All forms"
 msgstr "すべてのフォーム"
 #: admin/class-entry-list-table.php:487
+#: admin/class-entry-list-table.php:696
 #: admin/views/export.php:32
 msgid "From date"
 msgstr "開始日"
 #: admin/class-entry-list-table.php:489
+#: admin/class-entry-list-table.php:698
 #: admin/views/export.php:36
 msgid "To date"
 msgstr "終了日"
 #: admin/class-entry-list-table.php:494
+#: admin/class-entry-list-table.php:703
 msgid "Show spam"
 msgstr "スパムも表示"
 #: admin/class-entry-list-table.php:497
+#: admin/class-entry-list-table.php:726
 msgid "Filter"
 msgstr "絞り込み"
 #. translators: %d: entry ID
 #: admin/views/entry-detail.php:31
+#: admin/views/entry-detail.php:32
 #, php-format
 msgid "Entry #%d"
 msgstr "問い合わせ #%d"
 #: admin/views/entry-detail.php:34
+#: admin/views/entry-detail.php:35
 msgid "Back to list"
 msgstr "一覧へ戻る"
 #: admin/views/entry-detail.php:47
+#: admin/views/entry-detail.php:48
 msgid "Submitted fields"
 msgstr "送信内容"
 #: admin/views/entry-detail.php:51
+#: admin/views/entry-detail.php:52
 msgid "No submitted fields stored."
 msgstr "送信フィールドが保存されていません。"
 #: admin/views/entry-detail.php:72
+#: admin/views/entry-detail.php:73
 msgid "Attachments (metadata only)"
 msgstr "添付ファイル（メタ情報のみ）"
 #: admin/views/entry-detail.php:76
+#: admin/views/entry-detail.php:77
 msgid "File name"
 msgstr "ファイル名"
 #: admin/views/entry-detail.php:77
+#: admin/views/entry-detail.php:78
 msgid "MIME"
 msgstr "MIME"
 #: admin/views/entry-detail.php:78
+#: admin/views/entry-detail.php:79
 msgid "Size (bytes)"
 msgstr "サイズ (bytes)"
 #: admin/views/entry-detail.php:91
+#: admin/views/entry-detail.php:92
 msgid "Only metadata is captured. The uploaded files themselves are not stored by this plugin."
 msgstr "添付ファイルの実体は保存せず、メタ情報（ファイル名・MIME・サイズ）のみを記録しています。"
 #: admin/views/entry-detail.php:102
+#: admin/views/entry-detail.php:103
 msgid "Note body"
 msgstr "メモ本文"
 #: admin/views/entry-detail.php:105
+#: admin/views/entry-detail.php:106
 msgid "Add note"
 msgstr "メモを追加"
 #: admin/views/entry-detail.php:109
+#: admin/views/entry-detail.php:110
 msgid "No notes yet."
 msgstr "まだメモはありません。"
 #: admin/class-entry-event-presenter.php:119
 #: admin/views/entry-detail.php:115
+#: admin/views/entry-detail.php:116
 msgid "Unknown user"
 msgstr "不明なユーザー"
 #: admin/views/entry-detail.php:238
+#: admin/views/entry-detail.php:261
 msgid "Change status"
 msgstr "ステータスを変更"
 #: admin/views/entry-detail.php:246
+#: admin/views/entry-detail.php:269
 msgid "Update"
 msgstr "更新"
 #: admin/views/entry-detail.php:251
+#: admin/views/entry-detail.php:274
 msgid "Submission info"
 msgstr "送信情報"
 #: admin/views/entry-detail.php:255
+#: admin/views/entry-detail.php:278
 #: includes/class-export-service.php:50
 msgid "Form ID"
 msgstr "フォーム ID"
 #: admin/views/entry-detail.php:256
+#: admin/views/entry-detail.php:279
 #: includes/class-export-service.php:55
 msgid "Submission page URL"
 msgstr "送信ページ URL"
 #: admin/views/entry-detail.php:260
+#: admin/views/entry-detail.php:283
 #: includes/class-export-service.php:56
 msgid "Referrer"
 msgstr "参照元"
 #: admin/views/entry-detail.php:264
+#: admin/views/entry-detail.php:287
 #: includes/class-export-service.php:57
 msgid "Landing URL"
 msgstr "ランディング URL"
 #: admin/views/entry-detail.php:270
+#: admin/views/entry-detail.php:293
 msgid "User Agent"
 msgstr "User Agent"
 #: admin/views/entry-detail.php:271
+#: admin/views/entry-detail.php:294
 #: includes/class-export-service.php:64
 msgid "IP address"
 msgstr "IP アドレス"
 #: admin/views/entry-detail.php:272
+#: admin/views/entry-detail.php:295
 #: includes/class-export-service.php:65
 msgid "Spam flag"
 msgstr "スパム判定"
 #: admin/views/entry-detail.php:272
+#: admin/views/entry-detail.php:295
 #: admin/views/export.php:62
 msgid "Spam"
 msgstr "スパム"
 #: admin/views/entry-detail.php:272
+#: admin/views/entry-detail.php:295
 msgid "Normal"
 msgstr "通常"
 …
 msgstr "設定を保存"
 #: includes/class-entry-repository.php:25
+#: includes/class-entry-repository.php:38
 msgid "New"
 msgstr "未対応"
 #: includes/class-entry-repository.php:26
+#: includes/class-entry-repository.php:39
 msgid "In progress"
 msgstr "対応中"
 #: includes/class-entry-repository.php:27
+#: includes/class-entry-repository.php:40
 msgid "On hold"
 msgstr "保留"
 #: includes/class-entry-repository.php:28
+#: includes/class-entry-repository.php:41
 msgid "Done"
 msgstr "完了"
 …
 msgstr "過去の問い合わせから対応履歴を準備しています。通常どおりご利用いただけます。"
-#. translators: 1: number of records processed, 2: total records, 3: percentage complete
-#: admin/class-admin-menu.php:188
-#, php-format
-msgid "%1$s of %2$s (%3$s%%)"
-msgstr "%2$s 件中 %1$s 件（%3$s%%）"
 #: admin/class-entry-event-presenter.php:54
 msgid "Status changed"
 …
 #: admin/class-entry-event-presenter.php:89
 #: admin/views/entry-detail.php:141
+#: admin/views/entry-detail.php:142
 msgid "Activity"
 msgstr "対応履歴"
 …
 msgstr "メモを見る"
 #: admin/views/entry-detail.php:143
+#: admin/views/entry-detail.php:145
 msgid "History from before this plugin was updated is limited to what could be reconstructed: the time each entry arrived and any notes already saved."
 msgstr "アップデート前の履歴は、受信日時と既存メモから確認できる範囲のみ表示されます。"
 #: admin/views/entry-detail.php:155
+#: admin/views/entry-detail.php:158
 msgid "No activity on this page."
 msgstr "このページに表示する対応履歴はありません。"
 #: admin/views/entry-detail.php:157
+#: admin/views/entry-detail.php:160
 msgid "Back to the latest activity"
 msgstr "最新の対応履歴へ戻る"
 #: admin/views/entry-detail.php:162
+#: admin/views/entry-detail.php:165
 msgid "Preparing activity history…"
 msgstr "対応履歴を準備しています…"
 #: admin/views/entry-detail.php:164
+#: admin/views/entry-detail.php:167
 msgid "No activity recorded yet."
 msgstr "対応履歴はまだありません。"
 #: admin/views/entry-detail.php:198
+#: admin/views/entry-detail.php:201
 msgid "Activity pagination"
 msgstr "対応履歴のページ送り"
 #. translators: 1: current page number, 2: total number of pages
 #: admin/views/entry-detail.php:203
+#: admin/views/entry-detail.php:206
 #, php-format
 msgid "Page %1$s of %2$s"
 msgstr "%2$s ページ中 %1$s ページ"
 #: admin/views/entry-detail.php:211
+#: admin/views/entry-detail.php:214
 msgid "Newer activity"
 msgstr "新しい対応履歴"
 #: admin/views/entry-detail.php:216
+#: admin/views/entry-detail.php:219
 msgid "Older activity"
 msgstr "古い対応履歴"
 …
 msgid "For entries received before this feature was added, activity is limited to the received timestamp and any internal notes already saved. Earlier status, trash, and spam changes were never recorded, so they are not shown."
 msgstr "この機能が追加される前に受信した問い合わせでは、対応履歴は受信日時と保存済みのメモのみとなります。それ以前のステータス・ゴミ箱・スパムの変更は記録されていないため、表示されません。"
+#. translators: 1: number of records processed, 2: total records to process, 3: percentage complete. "Records" counts processing units (entries plus notes), NOT the number of inquiries.
+#: admin/class-admin-menu.php:188
+#, php-format
+msgid "Processed %1$s of %2$s records (%3$s%%)."
+msgstr "%2$s 件の履歴データのうち %1$s 件を処理しました（%3$s%%）。"

neutrope-lead-desk-for-contact-form-7/trunk/languages/neutrope-lead-desk-for-contact-form-7.pot

-              r3666139
+              r3666532
 msgid ""
 msgstr ""
 "Project-Id-Version: Neutrope Lead Desk for Contact Form 7 0.2.0\n"
+"Project-Id-Version: Neutrope Lead Desk for Contact Form 7 0.3.0\n"
 "Report-Msgid-Bugs-To: https://wordpress.org/support/plugin/neutrope-lead-desk-for-contact-form-7\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 …
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
 "POT-Creation-Date: 2026-08-25T14:05:36+00:00\n"
+"POT-Creation-Date: 2026-08-26T04:22:33+00:00\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "X-Generator: WP-CLI 2.12.0\n"
 …
 msgstr ""
 #. translators: 1: number of records processed, 2: total records, 3: percentage complete
+#. translators: 1: number of records processed, 2: total records to process, 3: percentage complete. "Records" counts processing units (entries plus notes), NOT the number of inquiries.
 #: admin/class-admin-menu.php:188
 #, php-format
 msgid "%1$s of %2$s (%3$s%%)"
+msgid "Processed %1$s of %2$s records (%3$s%%)."
 msgstr ""
 …
 #: admin/class-entry-event-presenter.php:53
 #: admin/class-entry-list-table.php:238
 #: admin/views/entry-detail.php:253
+#: admin/class-entry-list-table.php:363
+#: admin/views/entry-detail.php:276
 #: includes/class-export-service.php:47
 msgid "Received"
 …
 #: admin/class-entry-event-presenter.php:89
 #: admin/views/entry-detail.php:141
+#: admin/views/entry-detail.php:142
 msgid "Activity"
 msgstr ""
 …
 #: admin/class-entry-event-presenter.php:119
 #: admin/views/entry-detail.php:115
+#: admin/views/entry-detail.php:116
 msgid "Unknown user"
 msgstr ""
 …
 msgstr ""
 #: admin/class-entry-list-table.php:211
+#: admin/class-entry-list-table.php:336
 #: admin/views/export.php:43
 msgid "All"
 msgstr ""
 #: admin/class-entry-list-table.php:227
 #: admin/class-entry-list-table.php:361
+#: admin/class-entry-list-table.php:352
+#: admin/class-entry-list-table.php:570
 #: admin/views/export.php:72
 msgid "Trash"
 msgstr ""
 #: admin/class-entry-list-table.php:239
 #: admin/class-entry-list-table.php:471
 #: admin/views/entry-detail.php:228
+#: admin/class-entry-list-table.php:364
+#: admin/class-entry-list-table.php:680
+#: admin/views/entry-detail.php:251
 #: admin/views/export.php:40
 #: includes/class-export-service.php:48
 …
 msgstr ""
 #: admin/class-entry-list-table.php:240
 #: admin/class-entry-list-table.php:479
 #: admin/views/entry-detail.php:254
+#: admin/class-entry-list-table.php:365
+#: admin/class-entry-list-table.php:688
+#: admin/views/entry-detail.php:277
 #: admin/views/export.php:51
 #: includes/class-export-service.php:49
 …
 msgstr ""
 #: admin/class-entry-list-table.php:241
+#: admin/class-entry-list-table.php:366
 #: admin/views/settings.php:73
 #: includes/class-export-service.php:51
 …
 msgstr ""
 #: admin/class-entry-list-table.php:242
+#: admin/class-entry-list-table.php:367
 #: admin/views/settings.php:77
 #: includes/class-export-service.php:52
 …
 msgstr ""
 #: admin/class-entry-list-table.php:243
+#: admin/class-entry-list-table.php:368
 #: admin/views/settings.php:81
 #: includes/class-export-service.php:53
 …
 msgstr ""
 #: admin/class-entry-list-table.php:244
+#: admin/class-entry-list-table.php:369
 msgid "Source"
 msgstr ""
 #: admin/class-entry-list-table.php:245
+#: admin/class-entry-list-table.php:370
 msgid "UTM source"
 msgstr ""
 #: admin/class-entry-list-table.php:246
 #: admin/views/entry-detail.php:96
+#: admin/class-entry-list-table.php:371
+#: admin/views/entry-detail.php:97
 msgid "Notes"
 msgstr ""
 #: admin/class-entry-list-table.php:264
 #: admin/class-entry-list-table.php:342
+#: admin/class-entry-list-table.php:473
+#: admin/class-entry-list-table.php:551
 msgid "Restore"
 msgstr ""
 #: admin/class-entry-list-table.php:269
+#: admin/class-entry-list-table.php:478
 msgid "Set status: New"
 msgstr ""
 #: admin/class-entry-list-table.php:270
+#: admin/class-entry-list-table.php:479
 msgid "Set status: In progress"
 msgstr ""
 #: admin/class-entry-list-table.php:271
+#: admin/class-entry-list-table.php:480
 msgid "Set status: On hold"
 msgstr ""
 #: admin/class-entry-list-table.php:272
+#: admin/class-entry-list-table.php:481
 msgid "Set status: Done"
 msgstr ""
 #: admin/class-entry-list-table.php:273
+#: admin/class-entry-list-table.php:482
 msgid "Move to trash"
 msgstr ""
 #: admin/class-entry-list-table.php:274
+#: admin/class-entry-list-table.php:483
 msgid "Mark as spam"
 msgstr ""
 #: admin/class-entry-list-table.php:299
+#: admin/class-entry-list-table.php:508
 msgid "View"
 msgstr ""
 #: admin/class-entry-list-table.php:430
+#: admin/class-entry-list-table.php:639
 msgid "None"
 msgstr ""
 #: admin/class-entry-list-table.php:437
+#: admin/class-entry-list-table.php:646
 msgid "No entries are in the trash."
 msgstr ""
 #: admin/class-entry-list-table.php:440
+#: admin/class-entry-list-table.php:649
 msgid "No entries match the current filters."
 msgstr ""
 #: admin/class-entry-list-table.php:468
 #: admin/class-entry-list-table.php:469
+#: admin/class-entry-list-table.php:677
+#: admin/class-entry-list-table.php:678
 msgid "Search keywords"
 msgstr ""
 #: admin/class-entry-list-table.php:473
+#: admin/class-entry-list-table.php:682
 msgid "All statuses"
 msgstr ""
 #: admin/class-entry-list-table.php:481
+#: admin/class-entry-list-table.php:690
 #: admin/views/export.php:54
 msgid "All forms"
 msgstr ""
 #: admin/class-entry-list-table.php:487
+#: admin/class-entry-list-table.php:696
 #: admin/views/export.php:32
 msgid "From date"
 msgstr ""
 #: admin/class-entry-list-table.php:489
+#: admin/class-entry-list-table.php:698
 #: admin/views/export.php:36
 msgid "To date"
 msgstr ""
 #: admin/class-entry-list-table.php:494
+#: admin/class-entry-list-table.php:703
 msgid "Show spam"
 msgstr ""
 #: admin/class-entry-list-table.php:497
+#: admin/class-entry-list-table.php:726
 msgid "Filter"
 msgstr ""
 #. translators: %d: entry ID
 #: admin/views/entry-detail.php:31
+#: admin/views/entry-detail.php:32
 #, php-format
 msgid "Entry #%d"
 msgstr ""
 #: admin/views/entry-detail.php:34
+#: admin/views/entry-detail.php:35
 msgid "Back to list"
 msgstr ""
 #: admin/views/entry-detail.php:47
+#: admin/views/entry-detail.php:48
 msgid "Submitted fields"
 msgstr ""
 #: admin/views/entry-detail.php:51
+#: admin/views/entry-detail.php:52
 msgid "No submitted fields stored."
 msgstr ""
 #: admin/views/entry-detail.php:72
+#: admin/views/entry-detail.php:73
 msgid "Attachments (metadata only)"
 msgstr ""
 #: admin/views/entry-detail.php:76
+#: admin/views/entry-detail.php:77
 msgid "File name"
 msgstr ""
 #: admin/views/entry-detail.php:77
+#: admin/views/entry-detail.php:78
 msgid "MIME"
 msgstr ""
 #: admin/views/entry-detail.php:78
+#: admin/views/entry-detail.php:79
 msgid "Size (bytes)"
 msgstr ""
 #: admin/views/entry-detail.php:91
+#: admin/views/entry-detail.php:92
 msgid "Only metadata is captured. The uploaded files themselves are not stored by this plugin."
 msgstr ""
 #: admin/views/entry-detail.php:102
+#: admin/views/entry-detail.php:103
 msgid "Note body"
 msgstr ""
 #: admin/views/entry-detail.php:105
+#: admin/views/entry-detail.php:106
 msgid "Add note"
 msgstr ""
 #: admin/views/entry-detail.php:109
+#: admin/views/entry-detail.php:110
 msgid "No notes yet."
 msgstr ""
 #: admin/views/entry-detail.php:143
+#: admin/views/entry-detail.php:145
 msgid "History from before this plugin was updated is limited to what could be reconstructed: the time each entry arrived and any notes already saved."
 msgstr ""
 #: admin/views/entry-detail.php:155
+#: admin/views/entry-detail.php:158
 msgid "No activity on this page."
 msgstr ""
 #: admin/views/entry-detail.php:157
+#: admin/views/entry-detail.php:160
 msgid "Back to the latest activity"
 msgstr ""
 #: admin/views/entry-detail.php:162
+#: admin/views/entry-detail.php:165
 msgid "Preparing activity history…"
 msgstr ""
 #: admin/views/entry-detail.php:164
+#: admin/views/entry-detail.php:167
 msgid "No activity recorded yet."
 msgstr ""
 #: admin/views/entry-detail.php:198
+#: admin/views/entry-detail.php:201
 msgid "Activity pagination"
 msgstr ""
 #. translators: 1: current page number, 2: total number of pages
 #: admin/views/entry-detail.php:203
+#: admin/views/entry-detail.php:206
 #, php-format
 msgid "Page %1$s of %2$s"
 msgstr ""
 #: admin/views/entry-detail.php:211
+#: admin/views/entry-detail.php:214
 msgid "Newer activity"
 msgstr ""
 #: admin/views/entry-detail.php:216
+#: admin/views/entry-detail.php:219
 msgid "Older activity"
 msgstr ""
 #: admin/views/entry-detail.php:238
+#: admin/views/entry-detail.php:261
 msgid "Change status"
 msgstr ""
 #: admin/views/entry-detail.php:246
+#: admin/views/entry-detail.php:269
 msgid "Update"
 msgstr ""
 #: admin/views/entry-detail.php:251
+#: admin/views/entry-detail.php:274
 msgid "Submission info"
 msgstr ""
 #: admin/views/entry-detail.php:255
+#: admin/views/entry-detail.php:278
 #: includes/class-export-service.php:50
 msgid "Form ID"
 msgstr ""
 #: admin/views/entry-detail.php:256
+#: admin/views/entry-detail.php:279
 #: includes/class-export-service.php:55
 msgid "Submission page URL"
 msgstr ""
 #: admin/views/entry-detail.php:260
+#: admin/views/entry-detail.php:283
 #: includes/class-export-service.php:56
 msgid "Referrer"
 msgstr ""
 #: admin/views/entry-detail.php:264
+#: admin/views/entry-detail.php:287
 #: includes/class-export-service.php:57
 msgid "Landing URL"
 msgstr ""
 #: admin/views/entry-detail.php:270
+#: admin/views/entry-detail.php:293
 msgid "User Agent"
 msgstr ""
 #: admin/views/entry-detail.php:271
+#: admin/views/entry-detail.php:294
 #: includes/class-export-service.php:64
 msgid "IP address"
 msgstr ""
 #: admin/views/entry-detail.php:272
+#: admin/views/entry-detail.php:295
 #: includes/class-export-service.php:65
 msgid "Spam flag"
 msgstr ""
 #: admin/views/entry-detail.php:272
+#: admin/views/entry-detail.php:295
 #: admin/views/export.php:62
 msgid "Spam"
 msgstr ""
 #: admin/views/entry-detail.php:272
+#: admin/views/entry-detail.php:295
 msgid "Normal"
 msgstr ""
 …
 msgstr ""
 #: includes/class-entry-repository.php:25
+#: includes/class-entry-repository.php:38
 msgid "New"
 msgstr ""
 #: includes/class-entry-repository.php:26
+#: includes/class-entry-repository.php:39
 msgid "In progress"
 msgstr ""
 #: includes/class-entry-repository.php:27
+#: includes/class-entry-repository.php:40
 msgid "On hold"
 msgstr ""
 #: includes/class-entry-repository.php:28
+#: includes/class-entry-repository.php:41
 msgid "Done"
 msgstr ""

neutrope-lead-desk-for-contact-form-7/trunk/neutrope-lead-desk-for-contact-form-7.php

-              r3666139
+              r3666532
  * Plugin URI:        https://neutrope.biz/neutrope-lead-desk-for-contact-form-7/
  * Description:       Save Contact Form 7 submissions to the database and manage them as leads in the WordPress admin (list, detail, status, notes, CSV export).
  * Version:           0.2.0
+ * Version:           0.3.0
  * Requires at least: 6.0
  * Requires PHP:      7.4
 …
+}
 define( 'NLDCF7_VERSION', '0.2.0' );
+define( 'NLDCF7_VERSION', '0.3.0' );
 define( 'NLDCF7_DB_VERSION', '1.1.0' );
 define( 'NLDCF7_PLUGIN_FILE', __FILE__ );

neutrope-lead-desk-for-contact-form-7/trunk/readme.txt

-              r3666139
+              r3666532
 Tested up to: 7.1
 Requires PHP: 7.4
 Stable tag: 0.2.0
+Stable tag: 0.3.0
 License: GPLv2 or later
 License URI: https://www.gnu.org/licenses/gpl-2.0.html
 …
 The free version is intentionally focused: it saves submissions reliably, gives you an admin list/detail UI, lets you change status, add internal notes, and export to CSV. It does this without pulling in external services, trackers, or upsell banners on unrelated screens.
+Version 0.3.0 is mainly a foundation release for add-ons: it adds documented, generic extension points so other plugins can add columns, filters and detail-screen panels without forking this one. Nothing in the plugin's own behaviour changes because of them, and no database change is involved. See "Extending the plugin" below.
 Since 0.2.0 each entry also keeps an **Activity Timeline** (対応履歴) so you can see what has already been done about an inquiry -- when it arrived, who changed its status and to what, when notes were added, and when it was moved to trash, restored, or marked as spam -- instead of inferring the handling history from the current status alone.
 …
 * Privacy-friendly defaults: IP capture is OFF by default
 * Opt-in data deletion on uninstall (off by default so accidental deletes don't nuke your leads)
+* Extensibility via action/filter hooks: `nldcf7_after_entry_saved`, `nldcf7_after_note_added`, `nldcf7_after_status_changed`, `nldcf7_after_entry_trashed`, `nldcf7_after_entry_restored`, `nldcf7_after_spam_changed`, `nldcf7_entry_data_before_insert`, `nldcf7_export_columns`, `nldcf7_export_row`, `nldcf7_statuses`, `nldcf7_event_render`, `nldcf7_required_capability`
+* Extensibility via action/filter hooks: `nldcf7_after_entry_saved`, `nldcf7_after_note_added`, `nldcf7_after_status_changed`, `nldcf7_after_entry_trashed`, `nldcf7_after_entry_restored`, `nldcf7_after_spam_changed`, `nldcf7_entry_data_before_insert`, `nldcf7_export_columns`, `nldcf7_export_row`, `nldcf7_statuses`, `nldcf7_event_labels`, `nldcf7_event_render`, `nldcf7_required_capability`
+* Since 0.3.0, nine further extension points let an add-on place panels on the entry detail screen, add list columns and filter controls, keep its own filter state across list actions, and constrain the entries query -- all documented under "Extending the plugin"
 **Requirements**
 …
 Please open an issue on the plugin's support forum or the project's issue tracker.
+== Extending the plugin ==
+Version 0.3.0 adds nine extension points for add-on developers. They are
+generic: this plugin knows nothing about what an add-on stores. All of them are
+no-ops when nothing is listening, so a site with no add-on behaves exactly as
+it did in 0.2.0.
+= nldcf7_entry_detail_main =
+Action. Introduced in 0.3.0. Fires on the entry detail screen after this
+plugin's own cards in the main column, before the column closes.
+`do_action( 'nldcf7_entry_detail_main', array $entry )`
+`$entry` is the entry row as stored, passed by value. The listener prints its
+own markup, including its own card wrapper, and is responsible for escaping it.
+Output is not buffered or altered.
+= nldcf7_entry_detail_sidebar =
+Action. Introduced in 0.3.0. The same contract, for the sidebar column. Two
+hooks exist so an add-on can place content in both columns of one screen.
+`do_action( 'nldcf7_entry_detail_sidebar', array $entry )`
+= nldcf7_entry_list_columns =
+Filter. Introduced in 0.3.0. Adds columns to the entries list.
+`apply_filters( 'nldcf7_entry_list_columns', array $columns )`
+Return the column map with your own keys appended; prefix them to avoid
+collisions. Core columns cannot be removed, renamed or repurposed -- every core
+key is restored to its own label after the filter runs, and the checkbox column
+is forced back to the front. Labels are plain text and are escaped on output.
+= nldcf7_entry_list_column_content =
+Filter. Introduced in 0.3.0. Renders a cell for a column you added.
+`apply_filters( 'nldcf7_entry_list_column_content', string $html, string $column_name, array $item )`
+Return HTML for your own column, or the value you were given for anything else.
+Escape your own output; the plugin then passes the result through
+`wp_kses_post()` as a second layer, so ordinary post markup survives while
+scripts and event handlers do not. A non-string return renders an empty cell.
+= nldcf7_entry_list_filters =
+Action. Introduced in 0.3.0. Fires inside the list's existing GET filter form,
+before the Filter button, so a plain select or input submits alongside the
+built-in filters.
+`do_action( 'nldcf7_entry_list_filters', array $current_args )`
+`$current_args` is this plugin's own sanitized filter state, for reference. You
+own your field names, your values and your escaping. No nonce is involved: the
+filter bar only reads.
+= nldcf7_entry_list_carried_args =
+Filter. Introduced in 0.3.0. Keeps your own filter state across the All and
+Trash views, the row actions, and the redirect after a row or bulk action.
+`apply_filters( 'nldcf7_entry_list_carried_args', array $args, array $core )`
+Add your own already-sanitized scalar values. The plugin re-checks the result
+afterwards: reserved keys (`page`, `paged`, `action`, `action2`, `entry_id`,
+`_wpnonce`, `_wp_http_referer`, `view`, `event_page`, `status_view`) are
+stripped, keys are normalised, non-scalars are dropped, and both value length
+and argument count are capped. Core values always win. Do not attempt to
+forward the whole query string.
+= nldcf7_entry_query_args =
+Filter. Introduced in 0.3.0. Adjusts the entries query using arguments the
+repository already understands, without writing SQL.
+`apply_filters( 'nldcf7_entry_query_args', array $args )`
+The most useful is `ids`, an array of entry IDs to restrict the query to.
+`$args['context']` says who is asking: `list` for the entries screen, `export`
+for CSV, `default` otherwise. Check it -- both callers share the same
+repository, so an unconditional constraint would also change what CSV exports.
+= nldcf7_entry_query_clauses =
+Filter. Introduced in 0.3.0. Constrains the entries query using a table of your
+own, resolved by the database rather than by loading matching IDs into PHP.
+`apply_filters( 'nldcf7_entry_query_clauses', array $parts, array $args )`
+`$parts` has four keys:
+* `join` -- a JOIN clause string.
+* `where` -- an array of condition strings, each using `%s` or `%d` placeholders.
+* `prepare_args` -- the values for those placeholders, in order.
+* `distinct` -- boolean, default false.
+Values must go in `prepare_args`, never inside the condition strings; the plugin
+passes them to `$wpdb->prepare()`. A single pre-built SQL string is not
+accepted. If the placeholder count and the value count disagree, the whole
+contribution is discarded. Table and column identifiers inside `join` are your
+responsibility. Set `distinct` when your JOIN can match a row more than once: it
+is applied to the row query and the count together, so the list total and
+pagination stay correct. `$args['context']` applies here too.
+= nldcf7_entry_list_items_prepared =
+Action. Introduced in 0.3.0. Fires once per list page after the rows are known
+and before any cell is rendered.
+`do_action( 'nldcf7_entry_list_items_prepared', array $items )`
+`$items` is the current page's rows only -- never the whole result set. Use it
+to load everything your columns need in one query and keep it in a
+request-local cache, instead of querying once per cell. It is read-only, has no
+return value, and fires with an empty array when the page has no rows. It
+belongs to the entries screen only and never fires during CSV export.
 == Screenshots ==
 …
 == Changelog ==
+= 0.3.0 =
+* Add: generic extension points for the entry detail screen -- `nldcf7_entry_detail_main` and `nldcf7_entry_detail_sidebar` -- so an add-on can place panels in either column without modifying this plugin.
+* Add: generic list extension points -- `nldcf7_entry_list_columns` for columns and `nldcf7_entry_list_column_content` for their cells. Core columns are protected: an add-on cannot remove, rename or repurpose one, and returned cell markup passes through `wp_kses_post()`.
+* Add: `nldcf7_entry_list_filters`, which places an add-on's own controls inside the existing filter bar.
+* Add: `nldcf7_entry_list_carried_args`, so an add-on's own filter stays applied across the All and Trash views and after row and bulk actions. Reserved keys such as nonces, action names and entry IDs are refused, non-scalar values are dropped, and size and count are capped, so a careless listener cannot put unsafe state into a list URL.
+* Add: `nldcf7_entry_query_args` for high-level query constraints, including the existing `ids` argument, and `nldcf7_entry_query_clauses` for constraints that live in an add-on's own table. Clauses are structured -- a JOIN, conditions with placeholders, and their values kept separate -- rather than a raw SQL string, and values always go through `$wpdb->prepare()`.
+* Add: optional `distinct` handling for add-on joins that can match a row more than once. It is applied to the row query and the count together, so the list and its total can never disagree.
+* Add: query context. The entries screen and the CSV exporter share one repository, so each query now says which it is. An add-on constraint meant for the list no longer reaches CSV export unless the add-on opts in.
+* Add: `nldcf7_entry_list_items_prepared`, which hands an add-on the current page's rows once, before any cell is rendered, so custom columns can load their data in a single query instead of one per cell.
+* Fix: the Activity preparation notice counted processing records (entries plus notes) but read as a number of inquiries. It now names the unit; the arithmetic is unchanged.
+* Fix: the "history from before this plugin was updated" note no longer appears on sites that installed this version fresh and therefore have no earlier history to explain.
+* No database change. The schema and database version (1.1.0) are identical to 0.2.0, no migration runs, and existing entries, notes, attachments, activity, settings, capabilities and URLs are untouched. With no add-on installed the plugin behaves exactly as 0.2.0 did.
 = 0.2.0 =
 …
 == Upgrade Notice ==
+= 0.3.0 =
+Adds a documented extension foundation for add-ons, plus two small Activity-history wording fixes. Your leads, notes, activity and database schema are unchanged, and no migration runs. With no add-on installed the plugin behaves exactly as before.
 = 0.2.0 =
 Adds a per-entry activity history. Existing entries have their received time and existing notes reconstructed in the background; status, trash, and spam changes made before this update were never recorded and are not invented. Existing lead data is preserved.

Plugin Directory

Context Navigation

Legend:

neutrope-lead-desk-for-contact-form-7/tags/0.3.0/admin/class-admin-menu.php

neutrope-lead-desk-for-contact-form-7/tags/0.3.0/admin/class-entry-detail-page.php

neutrope-lead-desk-for-contact-form-7/tags/0.3.0/admin/class-entry-list-table.php

neutrope-lead-desk-for-contact-form-7/tags/0.3.0/admin/views/entry-detail.php

neutrope-lead-desk-for-contact-form-7/tags/0.3.0/includes/class-entry-repository.php

neutrope-lead-desk-for-contact-form-7/tags/0.3.0/includes/class-export-service.php

neutrope-lead-desk-for-contact-form-7/tags/0.3.0/languages/neutrope-lead-desk-for-contact-form-7-ja.po

neutrope-lead-desk-for-contact-form-7/tags/0.3.0/languages/neutrope-lead-desk-for-contact-form-7.pot

neutrope-lead-desk-for-contact-form-7/tags/0.3.0/neutrope-lead-desk-for-contact-form-7.php

neutrope-lead-desk-for-contact-form-7/tags/0.3.0/readme.txt

neutrope-lead-desk-for-contact-form-7/trunk/admin/class-admin-menu.php

neutrope-lead-desk-for-contact-form-7/trunk/admin/class-entry-detail-page.php

neutrope-lead-desk-for-contact-form-7/trunk/admin/class-entry-list-table.php

neutrope-lead-desk-for-contact-form-7/trunk/admin/views/entry-detail.php

neutrope-lead-desk-for-contact-form-7/trunk/includes/class-entry-repository.php

neutrope-lead-desk-for-contact-form-7/trunk/includes/class-export-service.php

neutrope-lead-desk-for-contact-form-7/trunk/languages/neutrope-lead-desk-for-contact-form-7-ja.po

neutrope-lead-desk-for-contact-form-7/trunk/languages/neutrope-lead-desk-for-contact-form-7.pot

neutrope-lead-desk-for-contact-form-7/trunk/neutrope-lead-desk-for-contact-form-7.php

neutrope-lead-desk-for-contact-form-7/trunk/readme.txt

Download in other formats: