woocommerce/plugins/woocommerce-admin/src/Notes/NavigationNudge.php

94 lines
2.3 KiB
PHP
Raw Normal View History

<?php
/**
* WooCommerce Admin: Navigation Nudge.
*
* Adds a note to nudge users to opt in to navigation.
*/
namespace Automattic\WooCommerce\Admin\Notes;
defined( 'ABSPATH' ) || exit;
use Automattic\WooCommerce\Admin\Features\Features;
use Automattic\WooCommerce\Admin\Features\Navigation\Init as Navigation;
/**
* Navigation Nudge.
*/
class NavigationNudge {
/**
* Note traits.
*/
use NoteTraits;
/**
* Name of the note for use in the database.
*/
const NOTE_NAME = 'wc-admin-navigation-nudge';
/**
* Attach hooks.
*/
public function __construct() {
add_action( 'update_option_' . Navigation::TOGGLE_OPTION_NAME, array( $this, 'action_note' ), 10, 2 );
}
/**
* Should this note exist? (The navigation feature should exist.)
*/
public static function is_applicable() {
return Features::exists( 'navigation' );
}
/**
* Get the note.
*
* @return Note
*/
public static function get_note() {
if ( Features::is_enabled( 'navigation' ) || ! self::is_applicable() ) {
return;
}
$note = new Note();
$note->set_title( __( 'You now have access to the WooCommerce navigation', 'woocommerce-admin' ) );
$note->set_content( __( 'Were introducing a new navigation for a more intuitive and improved user experience. You can enable the beta version of the new experience in the Advanced Settings. Enable it now for your store.', 'woocommerce-admin' ) );
$note->set_type( Note::E_WC_ADMIN_NOTE_INFORMATIONAL );
$note->set_name( self::NOTE_NAME );
$note->set_source( 'woocommerce-admin' );
$note->add_action(
'enable-navigation',
__( 'Enable in Settings', 'woocommerce-admin' ),
admin_url( 'admin.php?page=wc-settings&tab=advanced&section=features' )
);
return $note;
}
/**
* Actions the note when the option is toggled.
*
* @param string $old_value Old value.
* @param string $value New value.
*/
public static function action_note( $old_value, $value ) {
if ( 'yes' !== $value ) {
return;
}
$data_store = Notes::load_data_store();
$note_ids = $data_store->get_notes_with_name( self::NOTE_NAME );
if ( ! empty( $note_ids ) ) {
$note = Notes::get_note( $note_ids[0] );
if ( Note::E_WC_ADMIN_NOTE_ACTIONED === $note->get_status() ) {
return;
}
$note->set_status( Note::E_WC_ADMIN_NOTE_ACTIONED );
$note->save();
}
}
}