preview->is_preview_mode( $this->get_main_id() ) ) { // PHPCS - this method is safe echo $plugin->preview->builder_wrapper( '' ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped } else { // PHPCS - this method is safe echo $this->get_content(); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped } } public function get_css_wrapper_selector(): string { return '.ehp-' . $this->get_main_id(); } public static function get_create_url(): string { $base_create_url = Theme_Utils::elementor()->documents->get_create_new_post_url( Source_Local::CPT ); return add_query_arg( [ 'template_type' => static::get_type() ], $base_create_url ); } public function get_name(): string { return static::get_type(); } protected static function get_templates_path(): string { return HELLOPLUS_PATH . '/modules/template-parts/templates/'; } public function filter_admin_row_actions( $actions ) { $built_with_elementor = parent::filter_admin_row_actions( [] ); if ( isset( $actions['trash'] ) ) { $delete = $actions['trash']; unset( $actions['trash'] ); $actions['trash'] = $delete; } if ( ! Utils::are_we_on_elementor_domains() ) { unset( $actions['edit'] ); unset( $actions['inline hide-if-no-js'] ); } return $built_with_elementor + $this->set_as_entire_site( $actions ); } public function set_as_entire_site( $actions ) { $multiple_published = static::are_multiple_post_published(); $active_doc = static::get_active_document(); if ( $multiple_published || empty( $active_doc ) || $this->get_main_id() !== $active_doc[0] ) { $actions['set_as_entire_site'] = sprintf( '%s', $this->get_post()->ID, wp_create_nonce( 'hello_plus_set_as_entire_site_' . $this->get_post()->ID ), rawurlencode( add_query_arg( null, null ) ), esc_html__( 'Set as Entire Site', 'hello-plus' ) ); } return $actions; } /** * Retrieve the template-document post. * There should be only one, so return null if not found, or found too many. * * @return ?int */ public static function get_document_post(): ?int { $posts = static::get_all_document_posts(); return ( 1 !== count( $posts ) ) ? null : $posts[0]; } public static function get_all_document_posts( array $args = [] ): array { $default_args = [ 'post_type' => Source_Local::CPT, 'fields' => 'ids', 'lazy_load_term_meta' => true, 'no_found_rows' => true, 'update_post_term_cache' => false, 'post_status' => 'publish', 'tax_query' => [ [ 'taxonomy' => static::TAXONOMY_TYPE_SLUG, 'field' => 'slug', 'terms' => static::get_type(), ], ], ]; $args = wp_parse_args( $args, $default_args ); $query = new WP_Query( $args ); return $query->posts; } public static function get_active_document(): array { return static::get_all_document_posts( [ 'post_status' => 'publish', 'posts_per_page' => 1, ], ); } public static function skip_document_in_location_in_preview( \ElementorPro\Modules\ThemeBuilder\Classes\Locations_Manager $locations_manager ) { $post_id = filter_input( INPUT_GET, 'elementor-preview', FILTER_VALIDATE_INT ); $document = Theme_Utils::elementor()->documents->get( $post_id ); if ( $document instanceof static ) { $documents = $locations_manager->get_documents_for_location( static::LOCATION ); foreach ( $documents as $post_id ) { $locations_manager->skip_doc_in_location( static::LOCATION, $post_id ); } } } /** * @return void */ public static function register_hooks(): void { add_action( 'display_post_states', [ static::get_class_full_name(), 'display_post_states' ], 10, 2 ); add_action( 'admin_notices', [ static::get_class_full_name(), 'maybe_display_notice' ] ); if ( Utils::has_pro() ) { add_action( 'elementor/theme/before_do_' . static::LOCATION, [ static::get_class_full_name(), 'skip_document_in_location_in_preview' ], ); } $post = static::get_document_post(); if ( is_null( $post ) ) { return; } if ( Theme_Utils::elementor()->preview->is_preview_mode() ) { $post_id = filter_input( INPUT_GET, 'elementor-preview', FILTER_VALIDATE_INT ); $document = Theme_Utils::elementor()->documents->get( $post_id ); if ( $document instanceof Ehp_Document_Base ) { return; } } if ( Theme_Utils::is_preview_for_document( $post ) ) { return; } $method_name = defined( 'ELEMENTOR_PRO_VERSION' ) ? 'maybe_get_template' : 'get_template'; add_action( static::get_template_hook(), [ static::get_class_full_name(), $method_name ], 10, 2 ); } public static function maybe_display_notice() { if ( 'edit-elementor_library' === get_current_screen()->id && static::are_multiple_post_published() ) { $admin_notices = Utils::elementor()->admin->get_component( 'admin-notices' ); $options = [ /* translators: %s: Widget Name (e.g. "Hello+ Header"). */ 'title' => sprintf( esc_html__( 'More than one %s published.', 'hello-plus' ), static::get_title() ), 'description' => sprintf( /* translators: %s: Widget Name (e.g. "Hello+ Header"). */ esc_html__( 'Please notice! Your site allows only one %s at a time. Please move one to ‘Draft’', 'hello-plus' ), static::get_title(), ), 'type' => 'error', 'icon' => false, ]; $admin_notices->print_admin_notice( $options ); } } public static function display_post_states( array $post_states, \WP_Post $post ): array { if ( 'publish' === $post->post_status && static::are_multiple_post_published() ) { $document = Utils::elementor()->documents->get( $post->ID ); if ( $document instanceof static ) { $post_states['error'] = sprintf( esc_html__( 'Error: multiple %s published', 'hello-plus' ), static::get_title() ); return $post_states; } } $active_doc = static::get_active_document(); if ( ! empty( $active_doc ) && $active_doc[0] === $post->ID ) { $post_states['active'] = sprintf( esc_html__( 'Active %s', 'hello-plus' ), static::get_title() ); } return $post_states; } public static function are_multiple_post_published(): bool { return static::get_published_post_count() > 1; } public static function get_published_post_count(): int { static $published_posts_count = []; if ( ! isset( $published_posts_count[ static::get_type() ] ) ) { $posts = static::get_all_document_posts(); $published_posts_count[ static::get_type() ] = count( $posts ); } return $published_posts_count[ static::get_type() ]; } public static function maybe_get_template( ?string $name, array $args ): void { $location_docs = Utils::maybe_has_pro_location_docs( static::LOCATION ); if ( ! empty( $location_docs ) ) { return; } static::get_template( $name, $args ); } public function save( $data ) { if ( empty( $data['settings']['template'] ) ) { $data['settings']['template'] = Page_Templates_Module::TEMPLATE_CANVAS; } $active_documents = static::get_active_document(); if ( ! empty( $active_documents ) ) { $data = $this->maybe_save_as_draft( $active_documents, $data ); } return parent::save( $data ); } protected function maybe_save_as_draft( $active_documents, $data ): array { if ( ! empty( $data['settings']['post_status'] ) && 'publish' === $data['settings']['post_status'] ) { $document_id = $this->get_main_id(); if ( ! in_array( $document_id, $active_documents, true ) ) { $data['settings']['post_status'] = 'draft'; add_filter( 'elementor/documents/ajax_save/return_data', [ $this, 'allow_only_one_active_document' ], 10, 2 ); } } return $data; } /** * @param $return_data * @param $document * * @return mixed * @throws \Exception */ public function allow_only_one_active_document( $return_data, $document ) { /* translators: %s: location (e.g. "header"). */ $message = sprintf( __( 'Your new %1$s has been saved as a "Draft". Activate this %1$s by navigating to Elementor > Saved Templates, and change your current %1$s\'s status to "Draft". Then publish your new %1$s.', 'hello-plus' ), static::LOCATION ); throw new \Exception( esc_html( $message ) ); } protected function get_remote_library_config() { $config = parent::get_remote_library_config(); $config['type'] = $this->get_name(); $config['default_route'] = 'templates/ehp-elements'; $config['autoImportSettings'] = true; return $config; } /** * The WP hook for rendering the relevant template. * * @return string */ abstract public static function get_template_hook(): string; /** * @param ?string $name * @param array $args * * @return mixed */ abstract public static function get_template( ?string $name, array $args ): void; }