Commit realizado el 12:13:52 08-04-2024
This commit is contained in:
576
wp-content/plugins/web-stories/includes/Admin/Dashboard.php
Normal file
576
wp-content/plugins/web-stories/includes/Admin/Dashboard.php
Normal file
@@ -0,0 +1,576 @@
|
||||
<?php
|
||||
/**
|
||||
* Dashboard class.
|
||||
*
|
||||
* Responsible for adding the stories dashboard to WordPress admin.
|
||||
*
|
||||
* @link https://github.com/googleforcreators/web-stories-wp
|
||||
*
|
||||
* @copyright 2020 Google LLC
|
||||
* @license https://www.apache.org/licenses/LICENSE-2.0 Apache License 2.0
|
||||
*/
|
||||
|
||||
/**
|
||||
* Copyright 2020 Google LLC
|
||||
*
|
||||
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
*
|
||||
* https://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*/
|
||||
|
||||
declare(strict_types = 1);
|
||||
|
||||
namespace Google\Web_Stories\Admin;
|
||||
|
||||
use Google\Web_Stories\Assets;
|
||||
use Google\Web_Stories\Context;
|
||||
use Google\Web_Stories\Decoder;
|
||||
use Google\Web_Stories\Experiments;
|
||||
use Google\Web_Stories\Font_Post_Type;
|
||||
use Google\Web_Stories\Integrations\Site_Kit;
|
||||
use Google\Web_Stories\Integrations\WooCommerce;
|
||||
use Google\Web_Stories\Locale;
|
||||
use Google\Web_Stories\Media\Types;
|
||||
use Google\Web_Stories\Service_Base;
|
||||
use Google\Web_Stories\Settings;
|
||||
use Google\Web_Stories\Shopping\Shopping_Vendors;
|
||||
use Google\Web_Stories\Story_Post_Type;
|
||||
use Google\Web_Stories\Tracking;
|
||||
|
||||
/**
|
||||
* Dashboard class.
|
||||
*/
|
||||
class Dashboard extends Service_Base {
|
||||
|
||||
/**
|
||||
* Script handle.
|
||||
*/
|
||||
public const SCRIPT_HANDLE = 'web-stories-dashboard';
|
||||
|
||||
/**
|
||||
* Admin page hook suffixes.
|
||||
*
|
||||
* @var array<string,string|bool> List of the admin pages' hook_suffix values.
|
||||
*/
|
||||
private array $hook_suffix = [];
|
||||
|
||||
/**
|
||||
* Experiments instance.
|
||||
*
|
||||
* @var Experiments Experiments instance.
|
||||
*/
|
||||
private Experiments $experiments;
|
||||
|
||||
/**
|
||||
* Site_Kit instance.
|
||||
*
|
||||
* @var Site_Kit Site_Kit instance.
|
||||
*/
|
||||
private Site_Kit $site_kit;
|
||||
|
||||
/**
|
||||
* Decoder instance.
|
||||
*
|
||||
* @var Decoder Decoder instance.
|
||||
*/
|
||||
private Decoder $decoder;
|
||||
|
||||
/**
|
||||
* Locale instance.
|
||||
*
|
||||
* @var Locale Locale instance.
|
||||
*/
|
||||
private Locale $locale;
|
||||
|
||||
/**
|
||||
* Google_Fonts instance.
|
||||
*
|
||||
* @var Google_Fonts Google_Fonts instance.
|
||||
*/
|
||||
private Google_Fonts $google_fonts;
|
||||
|
||||
/**
|
||||
* Assets instance.
|
||||
*
|
||||
* @var Assets Assets instance.
|
||||
*/
|
||||
private Assets $assets;
|
||||
|
||||
/**
|
||||
* Story_Post_Type instance.
|
||||
*
|
||||
* @var Story_Post_Type Story_Post_Type instance.
|
||||
*/
|
||||
private Story_Post_Type $story_post_type;
|
||||
|
||||
/**
|
||||
* Font_Post_Type instance.
|
||||
*
|
||||
* @var Font_Post_Type Font_Post_Type instance.
|
||||
*/
|
||||
private Font_Post_Type $font_post_type;
|
||||
|
||||
/**
|
||||
* Context instance.
|
||||
*
|
||||
* @var Context Context instance.
|
||||
*/
|
||||
private Context $context;
|
||||
|
||||
/**
|
||||
* Types instance.
|
||||
*
|
||||
* @var Types Types instance.
|
||||
*/
|
||||
private Types $types;
|
||||
|
||||
/**
|
||||
* Shopping_Vendors instance.
|
||||
*
|
||||
* @var Shopping_Vendors Shopping_Vendors instance.
|
||||
*/
|
||||
private Shopping_Vendors $shopping_vendors;
|
||||
|
||||
/**
|
||||
* WooCommerce instance.
|
||||
*
|
||||
* @var WooCommerce WooCommerce instance.
|
||||
*/
|
||||
private WooCommerce $woocommerce;
|
||||
|
||||
/**
|
||||
* Settings instance.
|
||||
*
|
||||
* @var Settings Settings instance.
|
||||
*/
|
||||
private Settings $settings;
|
||||
|
||||
/**
|
||||
* Dashboard constructor.
|
||||
*
|
||||
* @SuppressWarnings(PHPMD.ExcessiveParameterList)
|
||||
*
|
||||
* @since 1.0.0
|
||||
*
|
||||
* @param Experiments $experiments Experiments instance.
|
||||
* @param Site_Kit $site_kit Site_Kit instance.
|
||||
* @param Decoder $decoder Decoder instance.
|
||||
* @param Locale $locale Locale instance.
|
||||
* @param Google_Fonts $google_fonts Google_Fonts instance.
|
||||
* @param Assets $assets Assets instance.
|
||||
* @param Font_Post_Type $font_post_type Font_Post_Type instance.
|
||||
* @param Story_Post_Type $story_post_type Story_Post_Type instance.
|
||||
* @param Context $context Context instance.
|
||||
* @param Types $types Types instance.
|
||||
* @param Shopping_Vendors $shopping_vendors Shopping_Vendors instance.
|
||||
* @param WooCommerce $woocommerce WooCommerce instance.
|
||||
* @param Settings $settings Settings instance.
|
||||
*/
|
||||
public function __construct(
|
||||
Experiments $experiments,
|
||||
Site_Kit $site_kit,
|
||||
Decoder $decoder,
|
||||
Locale $locale,
|
||||
Google_Fonts $google_fonts,
|
||||
Assets $assets,
|
||||
Font_Post_Type $font_post_type,
|
||||
Story_Post_Type $story_post_type,
|
||||
Context $context,
|
||||
Types $types,
|
||||
Shopping_Vendors $shopping_vendors,
|
||||
WooCommerce $woocommerce,
|
||||
Settings $settings
|
||||
) {
|
||||
$this->experiments = $experiments;
|
||||
$this->decoder = $decoder;
|
||||
$this->site_kit = $site_kit;
|
||||
$this->locale = $locale;
|
||||
$this->google_fonts = $google_fonts;
|
||||
$this->assets = $assets;
|
||||
$this->font_post_type = $font_post_type;
|
||||
$this->story_post_type = $story_post_type;
|
||||
$this->context = $context;
|
||||
$this->types = $types;
|
||||
$this->shopping_vendors = $shopping_vendors;
|
||||
$this->woocommerce = $woocommerce;
|
||||
$this->settings = $settings;
|
||||
}
|
||||
|
||||
/**
|
||||
* Initializes the dashboard logic.
|
||||
*
|
||||
* @since 1.0.0
|
||||
*/
|
||||
public function register(): void {
|
||||
add_action( 'admin_menu', [ $this, 'add_menu_page' ] );
|
||||
add_action( 'admin_init', [ $this, 'redirect_menu_page' ] );
|
||||
add_action( 'admin_enqueue_scripts', [ $this, 'enqueue_assets' ] );
|
||||
add_action( 'admin_notices', [ $this, 'display_link_to_dashboard' ] );
|
||||
add_action( 'load-web-story_page_stories-dashboard', [ $this, 'load_stories_dashboard' ] );
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns the admin page's hook suffix.
|
||||
*
|
||||
* @since 1.0.0
|
||||
*
|
||||
* @param string $key The current admin page key.
|
||||
* @return bool|string The dashboard page's hook_suffix, or false if the user does not have the capability required.
|
||||
*/
|
||||
public function get_hook_suffix( string $key ) {
|
||||
return $this->hook_suffix[ $key ] ?? false;
|
||||
}
|
||||
|
||||
/**
|
||||
* Registers the dashboard admin menu page.
|
||||
*
|
||||
* @since 1.0.0
|
||||
*/
|
||||
public function add_menu_page(): void {
|
||||
$parent = 'edit.php?post_type=' . $this->story_post_type->get_slug();
|
||||
|
||||
$settings = $this->get_dashboard_settings();
|
||||
|
||||
/**
|
||||
* The edit_posts capability.
|
||||
*
|
||||
* @var string $edit_posts
|
||||
*/
|
||||
$edit_posts = $this->story_post_type->get_cap_name( 'edit_posts' );
|
||||
|
||||
$this->hook_suffix['stories-dashboard'] = add_submenu_page(
|
||||
$parent,
|
||||
__( 'Dashboard', 'web-stories' ),
|
||||
__( 'Dashboard', 'web-stories' ),
|
||||
$edit_posts, // phpcs:ignore WordPress.WP.Capabilities.Undetermined
|
||||
'stories-dashboard',
|
||||
[ $this, 'render' ],
|
||||
0
|
||||
);
|
||||
|
||||
if ( isset( $settings['canViewDefaultTemplates'] ) && $settings['canViewDefaultTemplates'] ) {
|
||||
$this->hook_suffix['stories-dashboard-explore'] = add_submenu_page(
|
||||
$parent,
|
||||
__( 'Explore Templates', 'web-stories' ),
|
||||
__( 'Explore Templates', 'web-stories' ),
|
||||
$edit_posts, // phpcs:ignore WordPress.WP.Capabilities.Undetermined
|
||||
'stories-dashboard#/templates-gallery',
|
||||
'__return_null',
|
||||
1
|
||||
);
|
||||
}
|
||||
|
||||
$this->hook_suffix['stories-dashboard-settings'] = add_submenu_page(
|
||||
$parent,
|
||||
__( 'Settings', 'web-stories' ),
|
||||
__( 'Settings', 'web-stories' ),
|
||||
$edit_posts, // phpcs:ignore WordPress.WP.Capabilities.Undetermined
|
||||
'stories-dashboard#/editor-settings',
|
||||
'__return_null',
|
||||
20
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Redirects to the correct Dashboard page when clicking on the top-level "Stories" menu item.
|
||||
*
|
||||
* @codeCoverageIgnore
|
||||
*
|
||||
* @since 1.0.0
|
||||
*/
|
||||
public function redirect_menu_page(): void {
|
||||
global $pagenow;
|
||||
|
||||
if ( ! isset( $_GET['page'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification.Recommended
|
||||
return;
|
||||
}
|
||||
|
||||
/**
|
||||
* Page slug.
|
||||
*
|
||||
* @var string $page
|
||||
*/
|
||||
$page = $_GET['page']; // phpcs:ignore WordPress.Security.NonceVerification.Recommended, WordPress.Security.ValidatedSanitizedInput.InputNotSanitized
|
||||
$page = sanitize_text_field( (string) wp_unslash( $page ) );
|
||||
|
||||
if ( 'admin.php' === $pagenow && 'stories-dashboard' === $page ) {
|
||||
wp_safe_redirect(
|
||||
add_query_arg(
|
||||
[
|
||||
'post_type' => $this->story_post_type->get_slug(),
|
||||
'page' => 'stories-dashboard',
|
||||
],
|
||||
admin_url( 'edit.php' )
|
||||
)
|
||||
);
|
||||
exit;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Preload API requests in the dashboard.
|
||||
*
|
||||
* Important: keep in sync with usage & definition in React app.
|
||||
*
|
||||
* @since 1.0.0
|
||||
*/
|
||||
public function load_stories_dashboard(): void {
|
||||
$rest_url = trailingslashit( $this->story_post_type->get_rest_url() );
|
||||
|
||||
$preload_paths = [
|
||||
'/web-stories/v1/settings/',
|
||||
'/web-stories/v1/publisher-logos/',
|
||||
'/web-stories/v1/users/me/',
|
||||
'/web-stories/v1/taxonomies/?' . build_query(
|
||||
[
|
||||
'type' => $this->story_post_type->get_slug(),
|
||||
'context' => 'edit',
|
||||
'hierarchical' => 'true',
|
||||
'show_ui' => 'true',
|
||||
]
|
||||
),
|
||||
$rest_url . '?' . build_query(
|
||||
[
|
||||
'_embed' => rawurlencode(
|
||||
implode(
|
||||
',',
|
||||
[ 'wp:lock', 'author' ]
|
||||
)
|
||||
),
|
||||
'context' => 'edit',
|
||||
'order' => 'desc',
|
||||
'orderby' => 'modified',
|
||||
'page' => 1,
|
||||
'per_page' => 24,
|
||||
'status' => rawurlencode(
|
||||
implode(
|
||||
',',
|
||||
[ 'draft', 'future', 'pending', 'publish', 'private' ]
|
||||
)
|
||||
),
|
||||
'_web_stories_envelope' => 'true',
|
||||
'_fields' => rawurlencode(
|
||||
implode(
|
||||
',',
|
||||
[
|
||||
'id',
|
||||
'title',
|
||||
'status',
|
||||
'date',
|
||||
'date_gmt',
|
||||
'modified',
|
||||
'modified_gmt',
|
||||
'story_poster',
|
||||
'link',
|
||||
'preview_link',
|
||||
'edit_link',
|
||||
'_links', // Needed for WP 6.1+.
|
||||
'_embedded',
|
||||
// _web_stories_envelope will add these fields, we need them too.
|
||||
'body',
|
||||
'status',
|
||||
'headers',
|
||||
]
|
||||
)
|
||||
),
|
||||
]
|
||||
),
|
||||
];
|
||||
|
||||
/**
|
||||
* Preload common data by specifying an array of REST API paths that will be preloaded.
|
||||
*
|
||||
* Filters the array of paths that will be preloaded.
|
||||
*
|
||||
* @since 1.0.0
|
||||
*
|
||||
* @param string[] $preload_paths Array of paths to preload.
|
||||
*/
|
||||
$preload_paths = apply_filters( 'web_stories_dashboard_preload_paths', $preload_paths );
|
||||
|
||||
$preload_data = array_reduce(
|
||||
$preload_paths,
|
||||
'\Google\Web_Stories\rest_preload_api_request',
|
||||
[]
|
||||
);
|
||||
|
||||
wp_add_inline_script(
|
||||
'wp-api-fetch',
|
||||
sprintf( 'wp.apiFetch.use( wp.apiFetch.createPreloadingMiddleware( %s ) );', wp_json_encode( $preload_data ) ),
|
||||
'after'
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Renders the dashboard page.
|
||||
*
|
||||
* @since 1.0.0
|
||||
*/
|
||||
public function render(): void {
|
||||
require_once WEBSTORIES_PLUGIN_DIR_PATH . 'includes/templates/admin/dashboard.php';
|
||||
}
|
||||
|
||||
/**
|
||||
* Enqueues dashboard scripts and styles.
|
||||
*
|
||||
* @since 1.0.0
|
||||
*
|
||||
* @param string $hook_suffix The current admin page.
|
||||
*/
|
||||
public function enqueue_assets( string $hook_suffix ): void {
|
||||
if ( $this->get_hook_suffix( 'stories-dashboard' ) !== $hook_suffix ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$this->assets->enqueue_script_asset( self::SCRIPT_HANDLE, [ Tracking::SCRIPT_HANDLE ], false );
|
||||
|
||||
$this->assets->enqueue_style_asset( self::SCRIPT_HANDLE, [ $this->google_fonts::SCRIPT_HANDLE ] );
|
||||
|
||||
wp_localize_script(
|
||||
self::SCRIPT_HANDLE,
|
||||
'webStories',
|
||||
[
|
||||
'publicPath' => $this->assets->get_base_url( 'assets/js/' ), // Required before the editor script is enqueued.
|
||||
'localeData' => $this->assets->get_translations( self::SCRIPT_HANDLE ), // Required for i18n setLocaleData.
|
||||
]
|
||||
);
|
||||
|
||||
// Dequeue forms.css, see https://github.com/googleforcreators/web-stories-wp/issues/349 .
|
||||
$this->assets->remove_admin_style( [ 'forms' ] );
|
||||
}
|
||||
|
||||
/**
|
||||
* Get dashboard settings as an array.
|
||||
*
|
||||
* @since 1.0.0
|
||||
*
|
||||
* @return array<string,bool|string|int|array<string,mixed>>
|
||||
*/
|
||||
public function get_dashboard_settings(): array {
|
||||
$new_story_url = admin_url(
|
||||
add_query_arg(
|
||||
[
|
||||
'post_type' => $this->story_post_type->get_slug(),
|
||||
],
|
||||
'post-new.php'
|
||||
)
|
||||
);
|
||||
|
||||
// Media settings.
|
||||
$max_upload_size = wp_max_upload_size();
|
||||
if ( ! $max_upload_size ) {
|
||||
$max_upload_size = 0;
|
||||
}
|
||||
$mime_types = $this->types->get_allowed_mime_types();
|
||||
$allowed_image_mime_types = $mime_types['image'];
|
||||
$vendors = wp_list_pluck( $this->shopping_vendors->get_vendors(), 'label' );
|
||||
|
||||
$auto_advance = $this->settings->get_setting( $this->settings::SETTING_NAME_AUTO_ADVANCE );
|
||||
$page_duration = $this->settings->get_setting( $this->settings::SETTING_NAME_DEFAULT_PAGE_DURATION );
|
||||
|
||||
$plugin_file = plugin_basename( WEBSTORIES_PLUGIN_FILE );
|
||||
$auto_updates = (array) get_site_option( 'auto_update_plugins', [] );
|
||||
$auto_updates_enabled = \in_array( $plugin_file, $auto_updates, true );
|
||||
$plugin_updates = get_site_transient( 'update_plugins' );
|
||||
$needs_update = \is_object( $plugin_updates ) &&
|
||||
property_exists( $plugin_updates, 'response' ) &&
|
||||
\is_array( $plugin_updates->response ) &&
|
||||
! empty( $plugin_updates->response[ $plugin_file ] );
|
||||
$can_update = current_user_can( 'update_plugins' );
|
||||
|
||||
$settings = [
|
||||
'isRTL' => is_rtl(),
|
||||
'userId' => get_current_user_id(),
|
||||
'locale' => $this->locale->get_locale_settings(),
|
||||
'newStoryURL' => $new_story_url,
|
||||
'archiveURL' => $this->story_post_type->get_archive_link(),
|
||||
'defaultArchiveURL' => $this->story_post_type->get_archive_link( true ),
|
||||
'cdnURL' => trailingslashit( WEBSTORIES_CDN_URL ),
|
||||
'allowedImageMimeTypes' => $allowed_image_mime_types,
|
||||
'version' => WEBSTORIES_VERSION,
|
||||
'encodeMarkup' => $this->decoder->supports_decoding(),
|
||||
'api' => [
|
||||
'stories' => trailingslashit( $this->story_post_type->get_rest_url() ),
|
||||
'media' => '/web-stories/v1/media/',
|
||||
'currentUser' => '/web-stories/v1/users/me/',
|
||||
'fonts' => trailingslashit( $this->font_post_type->get_rest_url() ),
|
||||
'users' => '/web-stories/v1/users/',
|
||||
'settings' => '/web-stories/v1/settings/',
|
||||
'pages' => '/wp/v2/pages/',
|
||||
'publisherLogos' => '/web-stories/v1/publisher-logos/',
|
||||
'taxonomies' => '/web-stories/v1/taxonomies/',
|
||||
'products' => '/web-stories/v1/products/',
|
||||
],
|
||||
'vendors' => $vendors,
|
||||
'maxUpload' => $max_upload_size,
|
||||
'maxUploadFormatted' => size_format( $max_upload_size ),
|
||||
'editPostsCapabilityName' => $this->story_post_type->get_cap_name( 'edit_posts' ),
|
||||
'capabilities' => [
|
||||
'canManageSettings' => current_user_can( 'manage_options' ),
|
||||
'canUploadFiles' => current_user_can( 'upload_files' ),
|
||||
],
|
||||
'canViewDefaultTemplates' => true,
|
||||
'plugins' => [
|
||||
'siteKit' => $this->site_kit->get_plugin_status(),
|
||||
'woocommerce' => $this->woocommerce->get_plugin_status(),
|
||||
'web-stories' => [
|
||||
'needsUpdate' => $needs_update && ! $auto_updates_enabled,
|
||||
'updateLink' => $can_update ? admin_url( 'plugins.php' ) : null,
|
||||
],
|
||||
],
|
||||
'flags' => array_merge(
|
||||
$this->experiments->get_experiment_statuses( 'general' ),
|
||||
$this->experiments->get_experiment_statuses( 'dashboard' ),
|
||||
),
|
||||
'globalAutoAdvance' => (bool) $auto_advance,
|
||||
'globalPageDuration' => (float) $page_duration,
|
||||
];
|
||||
|
||||
/**
|
||||
* Filters settings passed to the web stories dashboard.
|
||||
*
|
||||
* @since 1.0.0
|
||||
*
|
||||
* @param array $settings Array of settings passed to web stories dashboard.
|
||||
*/
|
||||
return apply_filters( 'web_stories_dashboard_settings', $settings );
|
||||
}
|
||||
|
||||
/**
|
||||
* Displays a link to the Web Stories dashboard on the WordPress list table view.
|
||||
*
|
||||
* @since 1.0.0
|
||||
*/
|
||||
public function display_link_to_dashboard(): void {
|
||||
if ( ! $this->context->is_story_editor() ) {
|
||||
return;
|
||||
}
|
||||
|
||||
if ( 'edit' !== $this->context->get_screen_base() ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$dashboard_url = add_query_arg(
|
||||
[
|
||||
'post_type' => $this->story_post_type->get_slug(),
|
||||
'page' => 'stories-dashboard',
|
||||
],
|
||||
admin_url( 'edit.php' )
|
||||
)
|
||||
?>
|
||||
<div style="margin-top: 20px;">
|
||||
<a href="<?php echo esc_url( $dashboard_url ); ?>">
|
||||
<?php esc_html_e( '← Return to Web Stories Dashboard', 'web-stories' ); ?>
|
||||
</a>
|
||||
</div>
|
||||
<?php
|
||||
}
|
||||
}
|
Reference in New Issue
Block a user