%s', esc_url( self::url() ), esc_html__( 'Settings', 'thridify' ) ) );
return $links;
}
/**
* One contextual, dismissible prompt on the Plugins screen until connected.
*
* @return void
*/
public function plugins_screen_notice() {
$screen = get_current_screen();
if ( ! $screen || 'plugins' !== $screen->id || ! current_user_can( 'manage_woocommerce' ) || 'disconnected' !== Connection::status() ) {
return;
}
printf(
'',
esc_html__( 'Thridify is active. Connect your Thridify account to show 3D and AR on your products.', 'thridify' ),
esc_url( self::url() ),
esc_html__( 'Connect now', 'thridify' )
);
}
/**
* Settings page URL.
*
* @param string $tab Tab.
* @return string
*/
public static function url( $tab = '' ) {
$args = array( 'page' => self::SLUG );
if ( '' !== $tab ) {
$args['tab'] = $tab;
}
return add_query_arg( $args, admin_url( 'admin.php' ) );
}
/**
* Page styles.
*
* @param string $hook Page hook.
* @return void
*/
public function assets( $hook ) {
if ( 'woocommerce_page_' . self::SLUG !== $hook ) {
return;
}
wp_enqueue_style( 'thridify-admin', THRIDIFY_URL . 'assets/css/thridify-admin.css', array(), THRIDIFY_VERSION );
wp_enqueue_style( 'wp-color-picker' );
wp_enqueue_script( 'thridify-admin-settings', THRIDIFY_URL . 'assets/js/thridify-admin-settings.js', array( 'wp-color-picker' ), THRIDIFY_VERSION, true );
}
/**
* The current tab.
*
* @return string
*/
private function tab() {
// phpcs:ignore WordPress.Security.NonceVerification.Recommended -- read-only tab navigation.
$tab = isset( $_GET['tab'] ) ? sanitize_key( wp_unslash( $_GET['tab'] ) ) : 'connection';
return in_array( $tab, array( 'connection', 'display', 'catalog', 'switcher', 'insights' ), true ) ? $tab : 'connection';
}
/**
* Render the page.
*
* @return void
*/
public function render() {
if ( ! current_user_can( 'manage_woocommerce' ) ) {
return;
}
$tab = $this->tab();
$tabs = array(
'connection' => __( 'Connection', 'thridify' ),
'display' => __( 'Display', 'thridify' ),
'catalog' => __( 'Catalog', 'thridify' ),
'switcher' => __( 'Experience switcher', 'thridify' ),
'insights' => __( 'Insights', 'thridify' ),
);
echo '';
echo '
' . esc_html__( 'Thridify 3D & AR', 'thridify' ) . ' ';
$this->notice();
echo '
';
foreach ( $tabs as $key => $label ) {
printf(
'%s ',
esc_url( self::url( $key ) ),
$key === $tab ? ' nav-tab-active' : '',
esc_html( $label )
);
}
echo ' ';
switch ( $tab ) {
case 'display':
$this->render_display();
break;
case 'catalog':
$this->render_catalog();
break;
case 'switcher':
$this->render_switcher();
break;
case 'insights':
$this->render_insights();
break;
default:
$this->render_connection();
}
echo '
';
if ( 'disconnected' === $status ) {
echo '
' . esc_html__( 'Connect your Thridify account', 'thridify' ) . ' ';
echo '
' . esc_html__( 'Thridify hosts your 3D, AR and configurator experiences. Connecting lets this store show them on matching products and keeps your catalog in sync. You will sign in to Thridify (or create an account), confirm, and come straight back here.', 'thridify' ) . '
';
$this->action_button( OAuth::ACTION_START, __( 'Connect with Thridify', 'thridify' ), 'primary' );
printf(
'
%s thridify.com
',
esc_html__( 'New to Thridify? Learn more at', 'thridify' )
);
} else {
if ( 'reconnect' === $status ) {
echo '
' . esc_html__( 'Reconnect required: Thridify no longer accepts this site\'s connection (it was revoked or replaced). Published experiences keep showing, but settings and catalog changes cannot reach Thridify until you connect again.', 'thridify' ) . '
';
}
echo '
' . esc_html__( 'Connected', 'thridify' ) . ' ';
echo '
';
if ( ! empty( $record['link_error'] ) ) {
printf(
'
',
esc_html__( 'Linking this site did not finish:', 'thridify' ),
esc_html( (string) $record['link_error'] )
);
$this->action_button( 'thridify_relink', __( 'Try again', 'thridify' ) );
}
echo '
';
if ( 'reconnect' === $status ) {
$this->action_button( OAuth::ACTION_START, __( 'Reconnect', 'thridify' ), 'primary', false );
}
printf(
'%s ',
esc_url( Env::host( 'shopper' ) ),
esc_html__( 'Open Thridify', 'thridify' )
);
$this->action_button( OAuth::ACTION_UNLINK, __( 'Disconnect', 'thridify' ), 'secondary', false, __( 'Disconnect this site from Thridify? The 3D viewer will stop showing.', 'thridify' ) );
echo '
';
}
echo '
' . esc_html__( 'Environment', 'thridify' ) . ' ';
echo '
' . esc_html__( 'Enterprise accounts can test experiences from Thridify\'s sandbox before publishing them to production. Each environment has its own connection.', 'thridify' ) . '
';
echo '
' . esc_html__( 'Brand kit', 'thridify' ) . ' ';
echo '
' . esc_html__( 'Also use this colour on your Thridify experiences everywhere they appear (shared links, QR codes, other channels).', 'thridify' ) . '
';
$this->action_button( 'thridify_push_brand', __( 'Send brand colour to Thridify', 'thridify' ) );
echo '
' . esc_html__( 'Catalog sync', 'thridify' ) . ' ';
echo '
' . esc_html__( 'Product IDs, SKUs, slugs and names of published products are sent to Thridify after connecting, a couple of minutes after products change, and daily. Prices, stock and customer data are never sent.', 'thridify' ) . '
';
echo '
';
if ( 'connected' === Connection::status() ) {
$this->action_button( 'thridify_sync_now', __( 'Sync now', 'thridify' ) );
}
printf(
'
%s ',
esc_url( admin_url( 'edit.php?post_type=product' ) ),
esc_html__( 'See 3D status per product', 'thridify' )
);
echo '
';
echo '
' . esc_html__( 'Experience switcher', 'thridify' ) . ' ';
echo '
' . esc_html__( 'The switcher lets shoppers jump between your experiences inside the viewer. This setting is stored in your Thridify account and applies everywhere your experiences appear.', 'thridify' ) . '
';
if ( 'connected' !== Connection::status() ) {
echo '
' . esc_html__( 'Connect your Thridify account to manage the switcher.', 'thridify' ) . '
' . esc_html( Api::error_message( $result ) ) . '
';
echo '
' . esc_html__( '3D-assisted sales', 'thridify' ) . ' ';
echo '
' . esc_html__( 'Measure how many orders follow a shopper using 3D or AR. When on, the storefront sets a first-party cookie (_thridify_3d, 30 days) after a shopper engages a 3D experience — only with statistics consent if you use a WP Consent API compatible cookie banner. Paid orders and refunds are labelled and reported to your Thridify analytics with the order ID, total, currency, item count and label. No customer data is sent.', 'thridify' ) . '
';
echo '
' . esc_html__( 'Last 30 days', 'thridify' ) . ' ';
echo '
' . esc_html__( 'Orders', 'thridify' ) . ' ' . esc_html__( 'Revenue (net of refunds)', 'thridify' ) . ' ';
$labels = array(
'3d' => __( 'After a 3D/AR engagement', 'thridify' ),
'none' => __( 'Without 3D', 'thridify' ),
'unknown' => __( 'Unknown (no consent)', 'thridify' ),
);
foreach ( $labels as $key => $label ) {
printf(
'%s %s %s
';
$total = $summary['3d']['orders'] + $summary['none']['orders'];
if ( $total > 0 ) {
printf(
'
%s
',
/* translators: %s: percentage of orders. */
esc_html( sprintf( __( '%s of orders with a known outcome followed a 3D/AR engagement.', 'thridify' ), number_format_i18n( 100 * $summary['3d']['orders'] / $total, 1 ) . '%' ) )
);
}
echo '
' . esc_html__( 'Full funnel analytics (views, engagement, AR sessions) are in your Thridify dashboard.', 'thridify' ) . '
*/
private function posted_settings() {
// phpcs:ignore WordPress.Security.NonceVerification.Missing, WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- nonce verified in guard(); every key is sanitized by Settings::sanitize().
$raw = isset( $_POST['thridify'] ) && is_array( $_POST['thridify'] ) ? wp_unslash( $_POST['thridify'] ) : array();
return array_map(
static function ( $value ) {
return is_scalar( $value ) ? sanitize_text_field( (string) $value ) : '';
},
$raw
);
}
/**
* Redirect back to a tab.
*
* @param string $tab Tab.
* @param string $notice Notice code.
* @return void
*/
private function back( $tab, $notice ) {
wp_safe_redirect( add_query_arg( 'thridify_notice', $notice, self::url( $tab ) ) );
exit;
}
/**
* A button that posts a nonce-protected admin-post action.
*
* @param string $action Action (also the nonce action).
* @param string $label Label.
* @param string $type primary|secondary.
* @param bool $block Wrap in a paragraph.
* @param string|null $confirm Confirmation question.
* @return void
*/
private function action_button( $action, $label, $type = 'secondary', $block = true, $confirm = null ) {
if ( $block ) {
echo '';
}
printf(
'
',
esc_attr( $action ),
esc_attr( $type ),
esc_html( $label )
);
echo $block ? '' : ' ';
}
/**
* A read-only table row.
*
* @param string $label Label.
* @param string $value Value.
* @return void
*/
private function row( $label, $value ) {
printf( '%s %s %s %s $options Options.
* @return string
*/
private function select_html( $key, $current, array $options ) {
$html = sprintf( '', esc_attr( $key ) );
foreach ( $options as $value => $label ) {
$html .= sprintf( '%s ', esc_attr( $value ), selected( $current, $value, false ), esc_html( $label ) );
}
return $html . ' ';
}
/**
* Echo a select control.
*
* @param string $key Setting key.
* @param string $current Current value.
* @param array $options Options.
* @return void
*/
private function select( $key, $current, array $options ) {
echo wp_kses( $this->select_html( $key, $current, $options ), self::allowed_form_html() );
}
/**
* Tags allowed in settings controls.
*
* @return array>
*/
private static function allowed_form_html() {
return array(
'label' => array(),
'p' => array( 'class' => true ),
'select' => array( 'name' => true ),
'option' => array(
'value' => true,
'selected' => true,
),
'input' => array(
'type' => true,
'name' => true,
'value' => true,
'checked' => true,
'class' => true,
'min' => true,
'max' => true,
'maxlength' => true,
'placeholder' => true,
'data-default-color' => true,
),
);
}
}