%PDF-
%PDF-
Mini Shell
Mini Shell
<?php
/**
* Copyright (c) Facebook, Inc. and its affiliates. All Rights Reserved
*
* This source code is licensed under the license found in the
* LICENSE file in the root directory of this source tree.
*
* @package FacebookCommerce
*/
namespace WooCommerce\Facebook\Admin;
use Automattic\WooCommerce\Admin\Features\Features as WooAdminFeatures;
use WooCommerce\Facebook\Admin\Settings_Screens;
use WooCommerce\Facebook\Admin\Settings_Screens\Connection;
use WooCommerce\Facebook\Framework\Helper;
use WooCommerce\Facebook\Framework\Plugin\Exception as PluginException;
defined( 'ABSPATH' ) || exit;
/**
* Admin settings handler.
*
* @since 2.0.0
*/
class Settings {
/** @var string base settings page ID */
const PAGE_ID = 'wc-facebook';
/**
* Submenu page ID
*
* @var string
*/
const SUBMENU_PAGE_ID = 'edit-tags.php?taxonomy=fb_product_set&post_type=product';
/** @var Abstract_Settings_Screen[] */
private $screens;
/**
* Settings constructor.
*
* @param bool $is_connected is the state of the plugin connection to the Facebook Marketing API
* @since 2.0.0
*/
public function __construct( bool $is_connected ) {
$this->screens = $this->build_menu_item_array( $is_connected );
add_action( 'admin_menu', array( $this, 'add_menu_item' ) );
add_action( 'wp_loaded', array( $this, 'save' ) );
add_filter( 'parent_file', array( $this, 'set_parent_and_submenu_file' ) );
add_action( 'all_admin_notices', array( $this, 'add_tabs_to_product_sets_taxonomy' ) );
}
/**
* Arranges the tabs. If the plugin is connected to FB, Advertise tab will be first, otherwise the Connection tab will be the first tab.
*
* @param bool $is_connected is Facebook connected
* @since 3.0.7
*/
private function build_menu_item_array( bool $is_connected ): array {
$advertise = [ Settings_Screens\Advertise::ID => new Settings_Screens\Advertise() ];
$connection = [ Settings_Screens\Connection::ID => new Settings_Screens\Connection() ];
$first = ( $is_connected ) ? $advertise : $connection;
$last = ( $is_connected ) ? $connection : $advertise;
$screens = array(
Settings_Screens\Product_Sync::ID => new Settings_Screens\Product_Sync(),
Settings_Screens\Product_Sets::ID => new Settings_Screens\Product_Sets(),
);
return array_merge( array_merge( $first, $screens ), $last );
}
/**
* Adds the Facebook menu item.
*
* @since 2.0.0
*/
public function add_menu_item() {
$root_menu_item = $this->root_menu_item();
add_submenu_page(
$root_menu_item,
__( 'Facebook for WooCommerce', 'facebook-for-woocommerce' ),
__( 'Facebook', 'facebook-for-woocommerce' ),
'manage_woocommerce',
self::PAGE_ID,
[ $this, 'render' ],
5
);
$this->connect_to_enhanced_admin( $this->is_marketing_enabled() ? 'marketing_page_wc-facebook' : 'woocommerce_page_wc-facebook' );
}
/**
* Set the parent and submenu file while accessing Facebook Product Sets in the marketing menu.
*
* @since 2.6.29
* @param string $parent_file The parent file.
* @return string
*/
public function set_parent_and_submenu_file( $parent_file ) {
global $pagenow, $submenu_file;
$root_menu_item = $this->root_menu_item();
if ( 'edit-tags.php' === $pagenow || 'term.php' === $pagenow ) {
if ( isset( $_GET['taxonomy'] ) && 'fb_product_set' === $_GET['taxonomy'] ) { //phpcs:ignore WordPress.Security.NonceVerification.Recommended
$parent_file = $root_menu_item;
$submenu_file = self::PAGE_ID; //phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited
}
}
return $parent_file;
}
/**
* Get root menu item.
*
* @since 3.2.10
* return string Root menu item slug.
*/
public function root_menu_item() {
if ( $this->is_marketing_enabled() ) {
return 'woocommerce-marketing';
}
return 'woocommerce';
}
/**
* Check if marketing feature is enabled.
*
* @since 3.2.10
* return bool Is marketing enabled.
*/
public function is_marketing_enabled() {
if ( class_exists( WooAdminFeatures::class ) ) {
return WooAdminFeatures::is_enabled( 'marketing' );
}
return is_callable( '\Automattic\WooCommerce\Admin\Loader::is_feature_enabled' )
&& \Automattic\WooCommerce\Admin\Loader::is_feature_enabled( 'marketing' );
}
/**
* Enables enhanced admin support for the main Facebook settings page.
*
* @since 2.2.0
*
* @param string $screen_id the ID to connect to
*/
private function connect_to_enhanced_admin( $screen_id ) {
if ( is_callable( 'wc_admin_connect_page' ) ) {
$crumbs = array(
__( 'Facebook for WooCommerce', 'facebook-for-woocommerce' ),
);
//phpcs:ignore WordPress.Security.NonceVerification.Recommended
if ( ! empty( $_GET['tab'] ) ) {
//phpcs:ignore WordPress.Security.NonceVerification.Recommended
switch ( $_GET['tab'] ) {
case Connection::ID:
$crumbs[] = __( 'Connection', 'facebook-for-woocommerce' );
break;
case Settings_Screens\Product_Sync::ID:
$crumbs[] = __( 'Product sync', 'facebook-for-woocommerce' );
break;
case Settings_Screens\Advertise::ID:
$crumbs[] = __( 'Advertise', 'facebook-for-woocommerce' );
break;
}
}
wc_admin_connect_page(
array(
'id' => self::PAGE_ID,
'screen_id' => $screen_id,
'path' => add_query_arg( 'page', self::PAGE_ID, 'admin.php' ),
'title' => $crumbs,
)
);
}
}
/**
* Renders the settings page.
*
* @since 2.0.0
*/
public function render() {
$current_tab = $this->get_current_tab();
$screen = $this->get_screen( $current_tab );
?>
<div class="wrap woocommerce">
<?php $this->render_tabs( $current_tab ); ?>
<?php facebook_for_woocommerce()->get_message_handler()->show_messages(); ?>
<?php if ( $screen ) : ?>
<h1 class="screen-reader-text"><?php echo esc_html( $screen->get_title() ); ?></h1>
<p><?php echo wp_kses_post( $screen->get_description() ); ?></p>
<?php $screen->render(); ?>
<?php endif; ?>
</div>
<?php
}
/**
* Render the Facebook for WooCommerce extension navigation tabs.
*
* @since 3.3.0
*
* @param string $current_tab The current tab ID.
*/
public function render_tabs( $current_tab ) {
$tabs = $this->get_tabs();
?>
<nav class="nav-tab-wrapper woo-nav-tab-wrapper facebook-for-woocommerce-tabs">
<?php foreach ( $tabs as $id => $label ) : ?>
<a href="<?php echo esc_html( admin_url( 'admin.php?page=' . self::PAGE_ID . '&tab=' . esc_attr( $id ) ) ); ?>" class="nav-tab <?php echo $current_tab === $id ? 'nav-tab-active' : ''; ?>"><?php echo esc_html( $label ); ?></a>
<?php endforeach; ?>
</nav>
<?php
}
/**
* Get the current tab ID.
*
* @since 3.3.0
*
* @return string
*/
protected function get_current_tab() {
$tabs = $this->get_tabs();
$current_tab = Helper::get_requested_value( 'tab' );
if ( ! $current_tab ) {
$current_tab = current( array_keys( $tabs ) );
}
return $current_tab;
}
/**
* Saves the settings page.
*
* @since 2.0.0
*/
public function save() {
if ( ! is_admin() || Helper::get_requested_value( 'page' ) !== self::PAGE_ID ) {
return;
}
$screen = $this->get_screen( Helper::get_posted_value( 'screen_id' ) );
if ( ! $screen ) {
return;
}
if ( ! Helper::get_posted_value( 'save_' . $screen->get_id() . '_settings' ) ) {
return;
}
if ( ! current_user_can( 'manage_woocommerce' ) ) {
wp_die( esc_html__( 'You do not have permission to save these settings.', 'facebook-for-woocommerce' ) );
}
check_admin_referer( 'wc_facebook_admin_save_' . $screen->get_id() . '_settings' );
try {
$screen->save();
facebook_for_woocommerce()->get_message_handler()->add_message( __( 'Your settings have been saved.', 'facebook-for-woocommerce' ) );
} catch ( PluginException $exception ) {
facebook_for_woocommerce()->get_message_handler()->add_error(
sprintf(
/* translators: Placeholders: %s - user-friendly error message */
__( 'Your settings could not be saved. %s', 'facebook-for-woocommerce' ),
$exception->getMessage()
)
);
}
}
/**
* Gets a settings screen object based on ID.
*
* @since 2.0.0
*
* @param string $screen_id desired screen ID
* @return Abstract_Settings_Screen|null
*/
public function get_screen( $screen_id ) {
$screens = $this->get_screens();
return ! empty( $screens[ $screen_id ] ) && $screens[ $screen_id ] instanceof Abstract_Settings_Screen ? $screens[ $screen_id ] : null;
}
/**
* Gets the available screens.
*
* @since 2.0.0
*
* @return Abstract_Settings_Screen[]
*/
public function get_screens() {
/**
* Filters the admin settings screens.
*
* @since 2.0.0
*
* @param array $screens available screen objects
*/
$screens = (array) apply_filters( 'wc_facebook_admin_settings_screens', $this->screens, $this );
// ensure no bogus values are added via filter
$screens = array_filter(
$screens,
function ( $value ) {
return $value instanceof Abstract_Settings_Screen;
}
);
return $screens;
}
/**
* Gets the tabs.
*
* @since 2.0.0
*
* @return array
*/
public function get_tabs() {
$tabs = [];
foreach ( $this->get_screens() as $screen_id => $screen ) {
$tabs[ $screen_id ] = $screen->get_label();
}
/**
* Filters the admin settings tabs.
*
* @since 2.0.0
*
* @param array $tabs tab data, as $id => $label
*/
return (array) apply_filters( 'wc_facebook_admin_settings_tabs', $tabs, $this );
}
/**
* Add the Facebook for WooCommerce tabs to the Facebook Product Set taxonomy page.
* Renders the tabs (hidden by default) at the stop of the page,
* then moves them to the correct DOM location with JavaScript and displays them.
*
* @since 3.3.0
*/
public function add_tabs_to_product_sets_taxonomy() {
// Only load this on the edit-tags.php page
$screen = get_current_screen();
$is_taxonomy_list_page = 'edit-tags' === $screen->base;
$is_taxonomy_term_page = 'term' === $screen->base;
$is_taxonomy_page = $is_taxonomy_list_page || $is_taxonomy_term_page;
$is_product_set_taxonomy = 'fb_product_set' === $screen->taxonomy && $is_taxonomy_page;
if ( $is_product_set_taxonomy ) {
$this->render_tabs( Settings_Screens\Product_Sets::ID );
?>
<style>
.facebook-for-woocommerce-tabs {
margin: 30px 20px 0 20px;
}
#wpbody-content > .wrap > h1 {
font-size: 1.3em;
font-weight: 600;
}
@media (max-width: 782px) {
.facebook-for-woocommerce-tabs {
padding-top: 19px;
margin-bottom: -1px;
}
.edit-tags-php .facebook-for-woocommerce-tabs {
clear: both;
padding-top: 0;
position: relative;
top: -10px;
margin-bottom: -11px;
}
</style>
<?php
}
}
}
Zerion Mini Shell 1.0