0;
}
/**
* Does this site get a Reports entry, and with it the Journeys tab?
*
* The union of two conditions that used to gate two separate menu entries, now
* that one page carries both. has_stored_journeys() answers "is there anything to
* read", and handoff_enabled() covers the gap before the first journey arrives on
* a site that has just been configured to store them — without it, a site that
* turned handoff on this morning would have no way to reach the list it is about
* to fill.
*/
public static function journeys_ui_enabled() {
return BW_Lead_AI_Settings::handoff_enabled() || self::has_stored_journeys();
}
/**
* The query args that address the journeys list: the Reports page, Journeys view.
*
* One place, because every link into the list — the viewer's back link, the
* status filters, the search form's hidden inputs, the per-row View journey
* button and the redirect from the old slug — has to agree, and a list whose own
* links drop the view parameter walks the reader back to the aggregate report on
* their first click.
*/
public static function list_args() {
return array(
'page' => BW_Lead_AI_Admin::REPORTS_SLUG,
'view' => 'journeys',
);
}
public static function viewer_url( $token = '' ) {
$url = self::list_url();
return $token ? add_query_arg( 'token', rawurlencode( $token ), $url ) : $url;
}
public static function list_url() {
return add_query_arg( self::list_args(), admin_url( 'admin.php' ) );
}
/**
* The pre-1.7.0 viewer path, kept alive purely as a redirect.
*
* Journey links are written into records on a third-party system the moment a
* visitor converts, and they are meant to still work years later. Moving the
* admin menu changed the path, so every link already stored elsewhere would
* dead-end without this. Registering the old slug as a hidden Settings submenu
* is what keeps WordPress routing it at all.
*/
public static function legacy_viewer_url( $token = '' ) {
$url = admin_url( 'options-general.php?page=' . self::PAGE_SLUG );
return $token ? add_query_arg( 'token', rawurlencode( $token ), $url ) : $url;
}
/**
* Forward any older address for a journey to the Journeys view of Reports.
*
* Serves both of them: the pre-1.7.0 Settings path, where it is the registered
* page's callback, and the list's own former slug, where
* BW_Lead_AI_Admin::redirect_moved_screens() calls it on admin_init. One handler
* because the answer is the same either way, and because a second copy of this
* would be a second place for the carried parameters to fall out of step.
*
* Everything the list can be addressed by rides along — the token and the record
* hash so a CRM link opens the exact journey, the search, status and page so a
* bookmark of a filtered list opens filtered.
*
* On a site with no journeys the Reports page is not registered, so the fallback
* is Settings: a screen that always exists. That one is a 302, not a 301 — it is
* true only while the site has no journeys, and a browser that cached it
* permanently would keep sending journey links to Settings forever afterwards.
*/
public function redirect_legacy_journey_url() {
// phpcs:disable WordPress.Security.NonceVerification.Recommended -- read-only passthrough of an opaque token.
$args = array();
foreach ( array( 'token', 'record', 's', 'status', 'paged' ) as $key ) {
if ( isset( $_GET[ $key ] ) ) {
$args[ $key ] = sanitize_text_field( wp_unslash( $_GET[ $key ] ) );
}
}
// phpcs:enable
if ( ! self::journeys_ui_enabled() ) {
wp_safe_redirect( add_query_arg( array( 'page' => BW_Lead_AI_Admin::PAGE_SLUG ), admin_url( 'admin.php' ) ), 302 );
exit;
}
$target = add_query_arg(
array_merge( self::list_args(), $args ),
admin_url( 'admin.php' )
);
wp_safe_redirect( $target, 301 );
exit;
}
/**
* The journeys list has no menu entry of its own: it is the Journeys view of the
* Reports page, registered by BW_Lead_AI_Admin, and everything on that page's
* hook — this stylesheet included — is enqueued there. Only the legacy viewer
* redirect is registered here now, and a redirect renders nothing to style.
*/
public function menu() {
// Keep links stored elsewhere working — see legacy_viewer_url().
add_submenu_page(
'options-general.php',
__( 'Visitor journey', 'bw-lead-ai' ),
__( 'Visitor journey', 'bw-lead-ai' ),
self::view_capability(),
self::PAGE_SLUG,
array( $this, 'redirect_legacy_journey_url' )
);
remove_submenu_page( 'options-general.php', self::PAGE_SLUG );
}
public function handle_purge() {
// Purging and reprocessing rewrite the archive. Reading it is the view
// capability; changing it is not.
if ( ! BW_Lead_AI_Caps::can_manage() ) {
wp_die( esc_html__( 'You do not have permission to do that.', 'bw-lead-ai' ) );
}
check_admin_referer( self::PURGE_ACTION );
$deleted = BW_Lead_AI_Handoff_Store::purge_all();
wp_safe_redirect(
add_query_arg(
array( 'page' => BW_Lead_AI_Admin::PAGE_SLUG, 'tab' => 'journeys', 'bw_purged' => (int) $deleted ),
admin_url( 'admin.php' )
)
);
exit;
}
/**
* Re-derive attribution on stored journeys using the site's current settings.
*
* Sits alongside the purge handler on purpose: both are destructive-ish actions
* on the journey archive that live outside the settings form, and keeping them in
* one place means one pattern to get right — capability, nonce, do the work,
* redirect with a result. Never hooked to anything automatic; a visitor's stored
* history is only ever rewritten because someone chose to.
*/
public function handle_reprocess() {
// Purging and reprocessing rewrite the archive. Reading it is the view
// capability; changing it is not.
if ( ! BW_Lead_AI_Caps::can_manage() ) {
wp_die( esc_html__( 'You do not have permission to do that.', 'bw-lead-ai' ) );
}
check_admin_referer( self::REPROCESS_ACTION );
// Through the plugin's single POST reader — see BW_Lead_AI_Admin::posted().
$days = absint( BW_Lead_AI_Admin::posted( 'bw_reprocess_days' ) );
if ( ! in_array( $days, self::REPROCESS_SCOPES, true ) ) {
$days = 0;
}
$result = BW_Lead_AI_Reprocess::run( $days, true );
BW_Lead_AI_Reprocess::record_run( (int) $result['changed'] );
wp_safe_redirect(
add_query_arg(
array(
'page' => BW_Lead_AI_Admin::PAGE_SLUG,
'tab' => 'journeys',
'bw_reprocessed' => (int) $result['changed'],
'bw_examined' => (int) $result['examined'],
),
admin_url( 'admin.php' )
)
);
exit;
}
// --- helpers ---------------------------------------------------------
/** Stored timestamps are GMT; show them in the site's timezone and format. */
private function local_dt( $gmt, $with_time = true ) {
if ( empty( $gmt ) ) {
return '';
}
$format = get_option( 'date_format' ) . ( $with_time ? ' ' . get_option( 'time_format' ) : '' );
return mysql2date( $format, get_date_from_gmt( $gmt ) );
}
/**
* A journey timestamp (epoch ms, from the browser) in the site's timezone and
* date format. Falls back to whatever string the client sent when there is no
* usable timestamp, so older records still render.
*/
private function journey_dt( $ms, $fallback = '', $with_time = true ) {
$ms = (int) $ms;
if ( $ms <= 0 ) {
return (string) $fallback;
}
$format = get_option( 'date_format' ) . ( $with_time ? ' ' . get_option( 'time_format' ) : '' );
return wp_date( $format, (int) floor( $ms / 1000 ) );
}
/**
* The outcome control on a single journey — the same one the list carries.
*
* Directly under the hero rather than at the foot of the page: somebody
* reading one enquiry to decide what it is should not have to scroll past the
* whole browsing history to say so.
*/
private function render_outcome_form( $row ) {
if ( ! BW_Lead_AI_Caps::can_view() ) {
return;
}
$outcomes = BW_Lead_AI_Handoff_Store::outcomes();
$current = isset( $row['outcome'] ) ? (string) $row['outcome'] : '';
echo '';
}
/**
* The outcome cell: a select when the reader may set one, a label when not.
*
* Keyed by token hash rather than row id, because the hash is what already
* addresses a journey everywhere else on this screen and it is what the
* handler can validate the shape of without a database round trip.
*
* Returns escaped markup — every value that reaches the page goes through
* esc_attr() or esc_html() here, which is what the caller's phpcs:ignore
* refers to.
*/
private function outcome_control( $row, $outcomes, $can_flag ) {
$current = isset( $row['outcome'] ) ? (string) $row['outcome'] : '';
$hash = isset( $row['token_hash'] ) ? (string) $row['token_hash'] : '';
if ( ! $can_flag || '' === $hash ) {
return '' === $current
? '—'
: ''
. esc_html( isset( $outcomes[ $current ] ) ? $outcomes[ $current ] : $current ) . '';
}
$out = '';
$out .= '';
return $out;
}
/**
* Save whatever outcomes the reader just set.
*
* The same four steps every state-changing handler here takes — capability,
* nonce, work, redirect — with one thing worth naming: this is gated on the
* VIEW capability, not manage.
*
* That is deliberate. The split those capabilities draw is between reading the
* reports and changing what the site COLLECTS; deciding an enquiry was spam is
* neither. It is the daily work of exactly the person who was given read
* access — an admissions officer, a salesperson — and gating it on manage
* would hand them a screen full of enquiries they can read and cannot triage.
* Nothing here touches a setting, and every value is reversible.
*/
public function handle_outcome() {
if ( ! BW_Lead_AI_Caps::can_view() ) {
wp_die( esc_html__( 'You do not have permission to do that.', 'bw-lead-ai' ) );
}
check_admin_referer( self::OUTCOME_ACTION );
$posted = BW_Lead_AI_Admin::posted( 'outcome' );
$changed = 0;
if ( is_array( $posted ) ) {
$user = get_current_user_id();
foreach ( $posted as $hash => $value ) {
$value = sanitize_key( (string) $value );
// Unknown keys and unknown values are dropped rather than stored:
// the register is the whitelist, so a crafted POST can only ever
// write one of the values this site actually offers.
if ( ! BW_Lead_AI_Handoff_Store::is_outcome( $value ) ) {
continue;
}
if ( BW_Lead_AI_Handoff_Store::set_outcome( (string) $hash, $value, $user ) ) {
$changed++;
}
}
}
$ret = BW_Lead_AI_Admin::posted( 'ret' );
$args = self::list_args();
if ( is_array( $ret ) && ! empty( $ret['record'] ) ) {
// Saved from a single journey — go back to it, not to the list.
$args['record'] = sanitize_text_field( (string) $ret['record'] );
} elseif ( is_array( $ret ) ) {
foreach ( array( 'status', 's', 'paged' ) as $key ) {
if ( ! empty( $ret[ $key ] ) ) {
$args[ $key ] = sanitize_text_field( (string) $ret[ $key ] );
}
}
}
$args['bw_outcomes'] = $changed;
wp_safe_redirect( add_query_arg( $args, admin_url( 'admin.php' ) ) );
exit;
}
/**
* Put every conversion in exactly one visit, by visit index.
*
* Anchored on `visit_ts` — the browser clock of the visit that was running
* when the server recorded it — because the two clocks cannot be compared.
*
* **Every conversion is placed somewhere.** A journey keeps only the first
* and last few visits in full, so the visit a conversion names can have been
* trimmed out of the blob by the time anyone reads it; an older record has no
* anchor at all. Dropping those would take the one thing on this page that
* says the visitor converted and remove it precisely on the longest journeys.
* Unmatched conversions fall to the last visit, which is the nearest true
* thing: the submission happened at or after everything still on record.
*
* @param array $conversions Server-recorded submissions.
* @param array $visits The journey's visits, re-indexed from zero.
* @return array visit index => list of conversions.
*/
private function conversions_by_visit( $conversions, $visits ) {
$out = array();
$last = count( $visits ) - 1;
if ( $last < 0 ) {
return $out;
}
$at = array();
foreach ( $visits as $i => $visit ) {
if ( ! empty( $visit['ts'] ) ) {
$at[ (int) $visit['ts'] ] = $i;
}
}
foreach ( (array) $conversions as $c ) {
if ( ! is_array( $c ) ) {
continue;
}
$key = isset( $c['visit_ts'] ) ? (int) $c['visit_ts'] : 0;
$index = isset( $at[ $key ] ) ? $at[ $key ] : $last;
$out[ $index ][] = $c;
}
return $out;
}
/**
* Clock time for a conversion, from the GMT datetime the server stamped.
*
* Every other row on the timeline is a browser timestamp; this one is not,
* which is why it does not go through journey_dt(). Same display format, so
* the column still reads as one column.
*/
private function conversion_clock( $gmt ) {
$ts = strtotime( (string) $gmt . ' +00:00' );
return $ts ? wp_date( get_option( 'time_format' ), $ts ) : '';
}
/** Shorten a URL to its path for display, keeping the full value in a title attr. */
private function short_path( $url ) {
$path = wp_parse_url( (string) $url, PHP_URL_PATH );
return $path ? $path : (string) $url;
}
private function decode_journey( $payload ) {
if ( empty( $payload['journey'] ) ) {
return null;
}
$j = json_decode( (string) $payload['journey'], true );
return is_array( $j ) ? $j : null;
}
/** "12 days" / "same day" between two ms-epoch values. */
private function span_label( $from_ms, $to_ms ) {
if ( ! $from_ms || ! $to_ms || $to_ms < $from_ms ) {
return '';
}
$days = (int) floor( ( $to_ms - $from_ms ) / 86400000 );
if ( $days < 1 ) {
return __( 'same day', 'bw-lead-ai' );
}
/* translators: %s is a number of days. */
return sprintf( _n( '%s day', '%s days', $days, 'bw-lead-ai' ), number_format_i18n( $days ) );
}
// --- the browse list -------------------------------------------------
/**
* One registered page, two modes: a single journey when the URL carries a
* token or record, otherwise the list.
*
* Deliberately not a separate hidden page — and now not a separate page at all.
* Under a top-level menu, admin.php resolves the required capability by looking
* the page up in $submenu, so a page removed from the menu with
* remove_submenu_page() becomes unreachable ("Sorry, you are not allowed to
* access this page"). Both modes are therefore views of the registered Reports
* page, which calls this; nothing here is registered, so there is nothing to
* authorise around.
*/
public function render_page() {
// phpcs:disable WordPress.Security.NonceVerification.Recommended -- read-only view selection.
$has_one = isset( $_GET['token'] ) || isset( $_GET['record'] );
// phpcs:enable
if ( $has_one ) {
$this->render_viewer();
return;
}
$this->render_list();
}
public function render_list() {
if ( ! current_user_can( self::view_capability() ) ) {
wp_die( esc_html__( 'You do not have permission to view this.', 'bw-lead-ai' ) );
}
// phpcs:disable WordPress.Security.NonceVerification.Recommended -- read-only list filters.
$status = isset( $_GET['status'] ) ? sanitize_key( wp_unslash( $_GET['status'] ) ) : BW_Lead_AI_Handoff_Store::STATUS_SAVED;
$search = isset( $_GET['s'] ) ? sanitize_text_field( wp_unslash( $_GET['s'] ) ) : '';
$paged = isset( $_GET['paged'] ) ? max( 1, absint( wp_unslash( $_GET['paged'] ) ) ) : 1;
// phpcs:enable
$per_page = 25;
$result = BW_Lead_AI_Handoff_Store::list_records(
array( 'status' => $status, 'search' => $search, 'page' => $paged, 'per_page' => $per_page )
);
$rows = $result['rows'];
$total = $result['total'];
echo '
';
// The page heading stays "Reports" across every view, and the tab strip under
// it says which one you are on — wp-admin's own nav-tab strip, the same
// control the settings page uses. A heading that renamed itself per view
// would make the tabs look like separate pages that happen to share a menu
// entry.
echo '
'
. esc_html__( 'Journeys this site has kept a copy of.', 'bw-lead-ai' )
. ' '
. esc_html__( 'Saved journeys were confirmed by a form submission and are kept for the retention period. Held ones are provisional and expire unless a submission confirms them.', 'bw-lead-ai' )
. '
';
// Every arg that addresses this view has to ride along as a hidden input: a GET
// form replaces the whole query string, so a missing `view` would search the
// journeys and land the reader on the aggregate report.
echo '';
if ( empty( $rows ) ) {
echo '
';
return;
}
$show_person = BW_Lead_AI_Settings::capture_identity();
$outcomes = BW_Lead_AI_Handoff_Store::outcomes();
$can_flag = BW_Lead_AI_Caps::can_view();
/*
* One form around the whole table, with one save at the bottom.
*
* Triage is a scanning job — you read down twenty-five rows deciding which
* were real — so a control that reloads the page on every decision turns a
* two-minute pass into twenty-five page loads. Setting several and saving
* once is both faster and the only shape that needs no JavaScript, which
* matters for a control whose whole job is to still be there in five years.
*
* It cannot nest inside the search form above; that one is closed before
* this opens, and a nested form would be invalid HTML that browsers resolve
* by silently dropping one of them.
*/
if ( $can_flag ) {
echo '';
}
$pages_total = (int) ceil( $total / $per_page );
if ( $pages_total > 1 ) {
echo '
';
}
$meta = array( $this->local_dt( $when ) );
// To the visit they enquired on, not to the newest one — "first visit to
// enquiry" measured against a visit that happened after the enquiry is a
// span that never elapsed.
$ended = ( $enquiry && ! empty( $enquiry['ts'] ) ) ? $enquiry['ts'] : 0;
if ( ! $ended && $journey && ! empty( $journey['last']['ts'] ) ) {
$ended = $journey['last']['ts'];
}
if ( $journey && ! empty( $journey['first']['ts'] ) && $ended ) {
$span = $this->span_label( $journey['first']['ts'], $ended );
if ( $span ) {
/* translators: %s is a length of time, e.g. "12 days". */
$meta[] = sprintf( __( '%s from first visit to enquiry', 'bw-lead-ai' ), $span );
}
}
echo '
';
}
/**
* The visit they actually enquired on.
*
* **Not `journey.last`.** That is the NEWEST visit, and a journey carries on
* recording after the enquiry — so on a visitor who converted and then came
* back twice, `last` is a visit that happened after the thing this page is
* about, and the card would read "came back and enquired through" a channel
* they never enquired through. Same drift the reports had; this screen is the
* second place it surfaces.
*
* The conversion names the visit it happened on, so that visit is looked up
* by its own timestamp. A long journey keeps only the first and last few
* visits, so when the named one has been trimmed away the conversion's own
* frozen fields stand in — without a page or a time, because we genuinely no
* longer hold that visit and inventing one would be worse than the gap.
*
* Falls back to `journey.last` only for records stored before conversions
* were written, which is exactly the set whose credit has not been recovered
* either — so the card and the report still agree with each other.
*/
private function enquiry_touch( $journey, $conversions ) {
$last = ( $journey && ! empty( $journey['last'] ) ) ? $journey['last'] : null;
$c = ( is_array( $conversions ) && isset( $conversions[0] ) && is_array( $conversions[0] ) ) ? $conversions[0] : null;
if ( ! $c ) {
return $last;
}
$want = isset( $c['visit_ts'] ) ? (int) $c['visit_ts'] : 0;
if ( $want && ! empty( $journey['visits'] ) && is_array( $journey['visits'] ) ) {
foreach ( $journey['visits'] as $visit ) {
if ( is_array( $visit ) && isset( $visit['ts'] ) && (int) $visit['ts'] === $want ) {
return $visit;
}
}
}
$stand_in = array( 'ts' => 0, 'date' => '', 'page' => '' );
foreach ( array( 'channel', 'source', 'medium', 'campaign', 'term' ) as $key ) {
$stand_in[ $key ] = isset( $c[ $key ] ) ? (string) $c[ $key ] : '';
}
return ( '' === $stand_in['channel'] ) ? $last : $stand_in;
}
/**
* First touch vs the touch they enquired on — only shown as two columns when
* they differ, because on a same-session enquiry repeating the same thing
* twice is clutter.
*/
private function render_touchpoints( $journey, $enquiry, $conversions = array() ) {
$first = $journey && ! empty( $journey['first'] ) ? $journey['first'] : null;
if ( ! $first && ! $enquiry ) {
return;
}
$differs = $first && $enquiry
&& ( ( $first['channel'] !== $enquiry['channel'] ) || ( $first['campaign'] !== $enquiry['campaign'] ) );
echo '
' . esc_html__( 'How they found us', 'bw-lead-ai' ) . '
';
echo '
';
if ( $differs && $first ) {
echo '
';
echo '
' . esc_html__( 'First found us through', 'bw-lead-ai' ) . '
';
$this->render_touch_body( $first );
echo '
';
}
if ( $enquiry ) {
echo '
';
echo '
' . esc_html( $differs ? __( 'Came back and enquired through', 'bw-lead-ai' ) : __( 'Found us and enquired through', 'bw-lead-ai' ) ) . '
';
$this->render_touch_body( $enquiry );
echo '
';
}
echo '
';
if ( $differs ) {
echo '
'
. esc_html__( 'They arrived by one route and enquired by another — the first created awareness, the second converted.', 'bw-lead-ai' )
. '
';
}
// Say so when there are visits after the enquiry, rather than leaving a
// reader to wonder why the newest source they can see in the timeline is
// not the one being credited above.
$later = $this->visits_after_enquiry( $journey, $conversions );
if ( $later > 0 ) {
echo '
' . esc_html(
sprintf(
/* translators: %d is a number of visits. */
_n(
'They came back %d time after enquiring. That visit is in the timeline below and does not take credit for an enquiry that had already happened.',
'They came back %d times after enquiring. Those visits are in the timeline below and do not take credit for an enquiry that had already happened.',
$later,
'bw-lead-ai'
),
$later
)
) . '
';
}
}
/** How many visits are recorded after the one they enquired on. */
private function visits_after_enquiry( $journey, $conversions ) {
if ( empty( $conversions[0]['visit_ts'] ) || empty( $journey['visits'] ) || ! is_array( $journey['visits'] ) ) {
return 0;
}
$at = (int) $conversions[0]['visit_ts'];
$later = 0;
foreach ( $journey['visits'] as $visit ) {
if ( is_array( $visit ) && ! empty( $visit['ts'] ) && (int) $visit['ts'] > $at ) {
$later++;
}
}
return $later;
}
private function render_touch_body( $touch ) {
echo '
';
}
/**
* The main event: a timeline grouped by visit, with pages, interactions and
* submissions interleaved, **newest first**.
*
* @param array $journey The decoded journey blob, as the browser sent it.
* @param array $conversions Submissions as the SERVER recorded them. A journey
* whose form lives on another domain has no other
* witness: the browser here never sees that submit
* event, so without these the timeline just stops at
* "left for " and the moment the visitor
* actually converted is nowhere on the page.
*/
private function render_timeline( $journey, $conversions = array() ) {
echo '
' . esc_html__( 'What they did', 'bw-lead-ai' ) . '
'
. esc_html__( 'No browsing history was captured for this visitor. Tick "Full browsing history" under Settings → Journey Storage → Datapoints to collect it on future journeys.', 'bw-lead-ai' )
. '
';
return;
}
$visits = array_values( $journey['visits'] );
$views = isset( $journey['views'] ) ? $journey['views'] : array();
$events = isset( $journey['events'] ) ? $journey['events'] : array();
$subs = isset( $journey['submissions'] ) ? $journey['submissions'] : array();
$converted_by_visit = $this->conversions_by_visit( $conversions, $visits );
/*
* Assembled oldest-first and RENDERED newest-first.
*
* The two have to be separate passes: a visit's window runs to the start of
* the NEXT visit, so the grouping can only be worked out in order, while the
* reading order people actually want is the other one — the question in front
* of somebody opening a journey is almost always "what did they just do", and
* on a long journey the answer was at the bottom of the page.
*
* Both levels flip, visits and the items inside them. Reversing only one
* gives newest-visit-first with oldest-item-first inside it, which is worse
* than either order on its own.
*/
$rows = array();
foreach ( $visits as $i => $visit ) {
$start = isset( $visit['ts'] ) ? (int) $visit['ts'] : 0;
$end = isset( $visits[ $i + 1 ]['ts'] ) ? (int) $visits[ $i + 1 ]['ts'] : PHP_INT_MAX;
$converted = isset( $converted_by_visit[ $i ] ) ? $converted_by_visit[ $i ] : array();
$items = array();
foreach ( $views as $v ) {
if ( ! empty( $v['ts'] ) && $v['ts'] >= $start && $v['ts'] < $end ) {
$items[] = array( 'ts' => $v['ts'], 'kind' => 'page', 'text' => $v['page'] );
}
}
foreach ( $events as $e ) {
if ( ! empty( $e['ts'] ) && $e['ts'] >= $start && $e['ts'] < $end ) {
$items[] = array( 'ts' => $e['ts'], 'kind' => 'event', 'text' => $e['label'], 'type' => $e['type'], 'detail' => $e['detail'] );
}
}
// A submission the browser saw AND the server recorded is one
// submission. The server's is the one kept — it knows the form's name
// and it is the only one a cross-domain journey ever has.
foreach ( $subs as $s ) {
if ( $converted ) {
continue;
}
if ( ! empty( $s['ts'] ) && $s['ts'] >= $start && $s['ts'] < $end ) {
$items[] = array( 'ts' => $s['ts'], 'kind' => 'submit', 'text' => $s['page'] );
}
}
foreach ( $converted as $c ) {
/*
* Sorted by the SAME clock it is displayed with.
*
* It used to sort by `after_ts` — the last thing the browser had told
* us about before the submission — while showing the server's time,
* and those are not the same instant. Anything the browser reported
* after the save (the form-start event, the thank-you page) then
* landed below a row showing an earlier time, so the times column
* read 10:38, 10:40, 10:38, 10:40 and the sequence was unreadable.
*
* Sorting by the displayed time fixes that, and the cross-clock risk
* this file is careful about elsewhere does not apply here: which
* VISIT a conversion belongs to is still decided by `visit_ts`, on the
* browser's clock alone. This only orders it against its own visit,
* where both clocks are describing the same few minutes — and it is
* clamped so a badly-set device clock cannot push it out of that visit
* anyway, nor before the last thing we know it followed.
*/
$at = ! empty( $c['after_ts'] ) ? (int) $c['after_ts'] : 0;
if ( ! empty( $c['ts'] ) ) {
$secs = strtotime( (string) $c['ts'] . ' +00:00' );
if ( $secs ) {
$at = max( $at, $secs * 1000 );
}
}
if ( ! $at ) {
// No anchor and no clock: an older record. The end of the visit is
// the honest place — the submission is the last thing we know of.
$at = PHP_INT_MAX - 1;
}
if ( $at < $start ) {
$at = $start;
}
if ( PHP_INT_MAX !== $end && $at >= $end ) {
$at = $end - 1;
}
$items[] = array(
'ts' => $at,
'order' => 1,
'kind' => 'conversion',
'text' => isset( $c['context'] ) ? (string) $c['context'] : '',
'clock' => isset( $c['ts'] ) ? (string) $c['ts'] : '',
'via' => isset( $c['via'] ) ? (string) $c['via'] : '',
);
}
// `order` breaks the tie a shared anchor creates: the conversion
// happened on the page it is anchored to, so it comes after it.
usort(
$items,
function ( $a, $b ) {
if ( $a['ts'] !== $b['ts'] ) {
return $a['ts'] <=> $b['ts'];
}
$ao = isset( $a['order'] ) ? $a['order'] : 0;
$bo = isset( $b['order'] ) ? $b['order'] : 0;
return $ao <=> $bo;
}
);
if ( empty( $items ) && ! empty( $visit['page'] ) ) {
$items[] = array( 'ts' => $start, 'kind' => 'page', 'text' => $visit['page'] );
}
$rows[] = array( 'visit' => $visit, 'items' => $items );
}
echo '
';
foreach ( $items as $item ) {
// A conversion carries the SERVER's clock, so it is the one item
// here not read off a browser timestamp.
$time = ( 'conversion' === $item['kind'] )
? $this->conversion_clock( $item['clock'] )
: ( $item['ts'] ? wp_date( get_option( 'time_format' ), (int) floor( $item['ts'] / 1000 ) ) : '' );
echo '
'
. esc_html__( 'Most recent first. Times are shown in this site’s timezone, and only the first and last few visits are kept in full.', 'bw-lead-ai' )
. '
';
// The written summaries, if they were captured.
foreach ( array( 'summary', 'summary_detailed' ) as $key ) {
if ( empty( $p[ $key ] ) ) {
continue;
}
echo '