@wordpress/edit-site 5.18.0 → 5.19.0

package/src/components/sidebar-navigation-screen-pattern/index.js

@@ -16,11 +16,14 @@ import useInitEditedEntityFromURL from '../sync-state-with-url/use-init-edited-e
 import usePatternDetails from './use-pattern-details';
 import { store as editSiteStore } from '../../store';
 import { unlock } from '../../lock-unlock';
+import TemplateActions from '../template-actions';
 
 export default function SidebarNavigationScreenPattern() {
-	const { params } = useNavigator();
+	const navigator = useNavigator();
+	const {
+		params: { postType, postId },
+	} = navigator;
 	const { categoryType } = getQueryArgs( window.location.href );
-	const { postType, postId } = params;
 	const { setCanvasMode } = unlock( useDispatch( editSiteStore ) );
 
 	useInitEditedEntityFromURL();
@@ -38,11 +41,21 @@ export default function SidebarNavigationScreenPattern() {
 	return (
 		<SidebarNavigationScreen
 			actions={
-				<SidebarButton
-					onClick={ () => setCanvasMode( 'edit' ) }
-					label={ __( 'Edit' ) }
-					icon={ pencil }
-				/>
+				<>
+					<TemplateActions
+						postType={ postType }
+						postId={ postId }
+						toggleProps={ { as: SidebarButton } }
+						onRemove={ () => {
+							navigator.goTo( backPath );
+						} }
+					/>
+					<SidebarButton
+						onClick={ () => setCanvasMode( 'edit' ) }
+						label={ __( 'Edit' ) }
+						icon={ pencil }
+					/>
+				</>
 			}
 			backPath={ backPath }
 			{ ...patternDetails }

package/src/components/sidebar-navigation-screen-pattern/style.scss

@@ -24,6 +24,3 @@
 	margin-right: $grid-unit-10;
 }
 
-.edit-site-sidebar-navigation-screen-pattern__lock-icon {
-	display: inline-flex;
-}

package/src/components/sidebar-navigation-screen-pattern/use-pattern-details.js

@@ -35,10 +35,16 @@ export default function usePatternDetails( postType, postId ) {
 			select( editorStore ).__experimentalGetDefaultTemplatePartAreas(),
 		[]
 	);
-	const currentTheme = useSelect(
-		( select ) => select( coreStore ).getCurrentTheme(),
-		[]
-	);
+	const { currentTheme, userPatternCategories } = useSelect( ( select ) => {
+		const { getCurrentTheme, getUserPatternCategories } =
+			select( coreStore );
+
+		return {
+			currentTheme: getCurrentTheme(),
+			userPatternCategories: getUserPatternCategories(),
+		};
+	}, [] );
+
 	const addedBy = useAddedBy( postType, postId );
 	const isAddedByActiveTheme =
 		addedBy.type === 'theme' && record.theme === currentTheme?.stylesheet;
@@ -46,11 +52,18 @@ export default function usePatternDetails( postType, postId ) {
 	let description = getDescription();
 
 	if ( ! description && addedBy.text ) {
-		description = sprintf(
-			// translators: %s: pattern title e.g: "Header".
-			__( 'This is the %s pattern.' ),
-			getTitle()
-		);
+		description =
+			postType === 'wp_block'
+				? sprintf(
+						// translators: %s: pattern title e.g: "Header".
+						__( 'This is the %s pattern.' ),
+						getTitle()
+				  )
+				: sprintf(
+						// translators: %s: template part title e.g: "Header".
+						__( 'This is the %s template part.' ),
+						getTitle()
+				  );
 	}
 
 	if ( ! description && postType === 'wp_block' && record?.title ) {
@@ -61,10 +74,8 @@ export default function usePatternDetails( postType, postId ) {
 		);
 	}
 
-	const footer = !! record?.modified ? (
-		<SidebarNavigationScreenDetailsFooter
-			lastModifiedDateTime={ record.modified }
-		/>
+	const footer = record?.modified ? (
+		<SidebarNavigationScreenDetailsFooter record={ record } />
 	) : null;
 
 	const details = [];
@@ -77,6 +88,28 @@ export default function usePatternDetails( postType, postId ) {
 					? __( 'Not synced' )
 					: __( 'Fully synced' ),
 		} );
+
+		if ( record.wp_pattern_category?.length === 0 ) {
+			details.push( {
+				label: __( 'Categories' ),
+				value: __( 'Uncategorized' ),
+			} );
+		}
+		if ( record.wp_pattern_category?.length > 0 ) {
+			const patternCategories = new Map();
+			userPatternCategories.forEach( ( userCategory ) =>
+				patternCategories.set( userCategory.id, userCategory )
+			);
+
+			const categories = record.wp_pattern_category
+				.filter( ( category ) => patternCategories.get( category ) )
+				.map( ( category ) => patternCategories.get( category ).label );
+
+			details.push( {
+				label: __( 'Categories' ),
+				value: categories.length > 0 ? categories.join( ', ' ) : '',
+			} );
+		}
 	}
 
 	if ( postType === 'wp_template_part' ) {

package/src/components/sidebar-navigation-screen-patterns/index.js

@@ -4,16 +4,13 @@
 import {
 	__experimentalItemGroup as ItemGroup,
 	__experimentalItem as Item,
-	Flex,
-	Icon,
-	Tooltip,
 	__experimentalHeading as Heading,
 } from '@wordpress/components';
 import { useViewportMatch } from '@wordpress/compose';
 import { getTemplatePartIcon } from '@wordpress/editor';
-import { __, sprintf } from '@wordpress/i18n';
+import { __ } from '@wordpress/i18n';
 import { getQueryArgs } from '@wordpress/url';
-import { file, starFilled, lockSmall } from '@wordpress/icons';
+import { file } from '@wordpress/icons';
 
 /**
  * Internal dependencies
@@ -22,10 +19,9 @@ import AddNewPattern from '../add-new-pattern';
 import SidebarNavigationItem from '../sidebar-navigation-item';
 import SidebarNavigationScreen from '../sidebar-navigation-screen';
 import CategoryItem from './category-item';
-import { DEFAULT_CATEGORY, DEFAULT_TYPE } from '../page-patterns/utils';
+import { PATTERN_DEFAULT_CATEGORY, PATTERN_TYPES } from '../../utils/constants';
 import { useLink } from '../routes/link';
 import usePatternCategories from './use-pattern-categories';
-import useMyPatterns from './use-my-patterns';
 import useTemplatePartAreas from './use-template-part-areas';
 
 function TemplatePartGroup( { areas, currentArea, currentType } ) {
@@ -56,7 +52,11 @@ function TemplatePartGroup( { areas, currentArea, currentType } ) {
 	);
 }
 
-function ThemePatternsGroup( { categories, currentCategory, currentType } ) {
+function PatternCategoriesGroup( {
+	categories,
+	currentCategory,
+	currentType,
+} ) {
 	return (
 		<>
 			<ItemGroup className="edit-site-sidebar-navigation-screen-patterns__group">
@@ -64,29 +64,14 @@ function ThemePatternsGroup( { categories, currentCategory, currentType } ) {
 					<CategoryItem
 						key={ category.name }
 						count={ category.count }
-						label={
-							<Flex justify="left" align="center" gap={ 0 }>
-								{ category.label }
-								<Tooltip
-									position="top center"
-									text={ sprintf(
-										// translators: %s: The pattern category name.
-										'"%s" patterns cannot be edited.',
-										category.label
-									) }
-								>
-									<span className="edit-site-sidebar-navigation-screen-pattern__lock-icon">
-										<Icon icon={ lockSmall } size={ 24 } />
-									</span>
-								</Tooltip>
-							</Flex>
-						}
+						label={ category.label }
 						icon={ file }
 						id={ category.name }
 						type="pattern"
 						isActive={
 							currentCategory === `${ category.name }` &&
-							currentType === 'pattern'
+							( currentType === PATTERN_TYPES.theme ||
+								currentType === PATTERN_TYPES.user )
 						}
 					/>
 				) ) }
@@ -98,13 +83,12 @@ function ThemePatternsGroup( { categories, currentCategory, currentType } ) {
 export default function SidebarNavigationScreenPatterns() {
 	const isMobileViewport = useViewportMatch( 'medium', '<' );
 	const { categoryType, categoryId } = getQueryArgs( window.location.href );
-	const currentCategory = categoryId || DEFAULT_CATEGORY;
-	const currentType = categoryType || DEFAULT_TYPE;
+	const currentCategory = categoryId || PATTERN_DEFAULT_CATEGORY;
+	const currentType = categoryType || PATTERN_TYPES.user;
 
 	const { templatePartAreas, hasTemplateParts, isLoading } =
 		useTemplatePartAreas();
 	const { patternCategories, hasPatterns } = usePatternCategories();
-	const { myPatterns } = useMyPatterns();
 
 	const templatePartsLink = useLink( { path: '/wp_template_part/all' } );
 	const footer = ! isMobileViewport ? (
@@ -144,27 +128,8 @@ export default function SidebarNavigationScreenPatterns() {
 									</Item>
 								</ItemGroup>
 							) }
-							<ItemGroup className="edit-site-sidebar-navigation-screen-patterns__group">
-								<CategoryItem
-									key={ myPatterns.name }
-									count={
-										! myPatterns.count
-											? '0'
-											: myPatterns.count
-									}
-									label={ myPatterns.label }
-									icon={ starFilled }
-									id={ myPatterns.name }
-									type="wp_block"
-									isActive={
-										currentCategory ===
-											`${ myPatterns.name }` &&
-										currentType === 'wp_block'
-									}
-								/>
-							</ItemGroup>
 							{ hasPatterns && (
-								<ThemePatternsGroup
+								<PatternCategoriesGroup
 									categories={ patternCategories }
 									currentCategory={ currentCategory }
 									currentType={ currentType }

package/src/components/sidebar-navigation-screen-patterns/use-pattern-categories.js

@@ -9,6 +9,8 @@ import { __ } from '@wordpress/i18n';
  */
 import useDefaultPatternCategories from './use-default-pattern-categories';
 import useThemePatterns from './use-theme-patterns';
+import usePatterns from '../page-patterns/use-patterns';
+import { PATTERN_TYPES, PATTERN_DEFAULT_CATEGORY } from '../../utils/constants';
 
 export default function usePatternCategories() {
 	const defaultCategories = useDefaultPatternCategories();
@@ -17,6 +19,8 @@ export default function usePatternCategories() {
 		label: __( 'Uncategorized' ),
 	} );
 	const themePatterns = useThemePatterns();
+	const { patterns: userPatterns, categories: userPatternCategories } =
+		usePatterns( PATTERN_TYPES.user );
 
 	const patternCategories = useMemo( () => {
 		const categoryMap = {};
@@ -28,6 +32,11 @@ export default function usePatternCategories() {
 				categoryMap[ category.name ] = { ...category, count: 0 };
 			}
 		} );
+		userPatternCategories.forEach( ( category ) => {
+			if ( ! categoryMap[ category.name ] ) {
+				categoryMap[ category.name ] = { ...category, count: 0 };
+			}
+		} );
 
 		// Update the category counts to reflect theme registered patterns.
 		themePatterns.forEach( ( pattern ) => {
@@ -42,15 +51,48 @@ export default function usePatternCategories() {
 			}
 		} );
 
-		// Filter categories so we only have those containing patterns.
-		defaultCategories.forEach( ( category ) => {
-			if ( categoryMap[ category.name ].count ) {
-				categoriesWithCounts.push( categoryMap[ category.name ] );
+		// Update the category counts to reflect user registered patterns.
+		userPatterns.forEach( ( pattern ) => {
+			pattern.categories?.forEach( ( category ) => {
+				if ( categoryMap[ category ] ) {
+					categoryMap[ category ].count += 1;
+				}
+			} );
+			// If the pattern has no categories, add it to uncategorized.
+			if ( ! pattern.categories?.length ) {
+				categoryMap.uncategorized.count += 1;
 			}
 		} );
 
-		return categoriesWithCounts;
-	}, [ defaultCategories, themePatterns ] );
+		// Filter categories so we only have those containing patterns.
+		[ ...defaultCategories, ...userPatternCategories ].forEach(
+			( category ) => {
+				if (
+					categoryMap[ category.name ].count &&
+					! categoriesWithCounts.find(
+						( cat ) => cat.name === category.name
+					)
+				) {
+					categoriesWithCounts.push( categoryMap[ category.name ] );
+				}
+			}
+		);
+		const sortedCategories = categoriesWithCounts.sort( ( a, b ) =>
+			a.label.localeCompare( b.label )
+		);
+		sortedCategories.unshift( {
+			name: PATTERN_DEFAULT_CATEGORY,
+			label: __( 'All Patterns' ),
+			description: __( 'A list of all patterns from all sources' ),
+			count: themePatterns.length + userPatterns.length,
+		} );
+		return sortedCategories;
+	}, [
+		defaultCategories,
+		themePatterns,
+		userPatternCategories,
+		userPatterns,
+	] );
 
 	return { patternCategories, hasPatterns: !! patternCategories.length };
 }

package/src/components/sidebar-navigation-screen-patterns/use-theme-patterns.js

@@ -8,10 +8,8 @@ import { useMemo } from '@wordpress/element';
 /**
  * Internal dependencies
  */
-import {
-	CORE_PATTERN_SOURCES,
-	filterOutDuplicatesByName,
-} from '../page-patterns/utils';
+import { filterOutDuplicatesByName } from '../page-patterns/utils';
+import { PATTERN_CORE_SOURCES } from '../../utils/constants';
 import { unlock } from '../../lock-unlock';
 import { store as editSiteStore } from '../../store';
 
@@ -34,7 +32,7 @@ export default function useThemePatterns() {
 			[ ...( blockPatterns || [] ), ...( restBlockPatterns || [] ) ]
 				.filter(
 					( pattern ) =>
-						! CORE_PATTERN_SOURCES.includes( pattern.source )
+						! PATTERN_CORE_SOURCES.includes( pattern.source )
 				)
 				.filter( filterOutDuplicatesByName )
 				.filter( ( pattern ) => pattern.inserter !== false ),

package/src/components/sidebar-navigation-screen-template/index.js

@@ -48,10 +48,8 @@ function useTemplateDetails( postType, postId ) {
 			<HomeTemplateDetails />
 		) : null;
 
-	const footer = !! record?.modified ? (
-		<SidebarNavigationScreenDetailsFooter
-			lastModifiedDateTime={ record.modified }
-		/>
+	const footer = record?.modified ? (
+		<SidebarNavigationScreenDetailsFooter record={ record } />
 	) : null;
 
 	const description = (

package/src/components/sidebar-navigation-screen-templates/index.js

@@ -49,7 +49,7 @@ export default function SidebarNavigationScreenTemplates() {
 		<SidebarNavigationScreen
 			title={ __( 'Templates' ) }
 			description={ __(
-				'Express the layout of your site with templates'
+				'Express the layout of your site with templates.'
 			) }
 			actions={
 				canCreate && (

package/src/components/template-actions/index.js

@@ -67,10 +67,16 @@ export default function TemplateActions( {
 				}
 			);
 		} catch ( error ) {
+			const fallbackErrorMessage =
+				template.type === 'wp_template'
+					? __( 'An error occurred while reverting the template.' )
+					: __(
+							'An error occurred while reverting the template part.'
+					  );
 			const errorMessage =
 				error.message && error.code !== 'unknown_error'
 					? error.message
-					: __( 'An error occurred while reverting the entity.' );
+					: fallbackErrorMessage;
 
 			createErrorNotice( errorMessage, { type: 'snackbar' } );
 		}
@@ -97,7 +103,7 @@ export default function TemplateActions( {
 									onRemove?.();
 									onClose();
 								} }
-								isTemplate={ template.type === 'wp_template' }
+								title={ template.title.rendered }
 							/>
 						</>
 					) }
@@ -120,7 +126,7 @@ export default function TemplateActions( {
 	);
 }
 
-function DeleteMenuItem( { onRemove, isTemplate } ) {
+function DeleteMenuItem( { onRemove, title } ) {
 	const [ isModalOpen, setIsModalOpen ] = useState( false );
 	return (
 		<>
@@ -133,11 +139,11 @@ function DeleteMenuItem( { onRemove, isTemplate } ) {
 				onCancel={ () => setIsModalOpen( false ) }
 				confirmButtonText={ __( 'Delete' ) }
 			>
-				{ isTemplate
-					? __( 'Are you sure you want to delete this template?' )
-					: __(
-							'Are you sure you want to delete this template part?'
-					  ) }
+				{ sprintf(
+					// translators: %s: The template or template part's title.
+					__( 'Are you sure you want to delete "%s"?' ),
+					decodeEntities( title )
+				) }
 			</ConfirmDialog>
 		</>
 	);

package/src/components/template-actions/rename-menu-item.js

@@ -56,14 +56,25 @@ export default function RenameMenuItem( { template, onClose } ) {
 				}
 			);
 
-			createSuccessNotice( __( 'Entity renamed.' ), {
-				type: 'snackbar',
-			} );
+			createSuccessNotice(
+				template.type === 'wp_template'
+					? __( 'Template renamed.' )
+					: __( 'Template part renamed.' ),
+				{
+					type: 'snackbar',
+				}
+			);
 		} catch ( error ) {
+			const fallbackErrorMessage =
+				template.type === 'wp_template'
+					? __( 'An error occurred while renaming the template.' )
+					: __(
+							'An error occurred while renaming the template part.'
+					  );
 			const errorMessage =
 				error.message && error.code !== 'unknown_error'
 					? error.message
-					: __( 'An error occurred while renaming the entity.' );
+					: fallbackErrorMessage;
 
 			createErrorNotice( errorMessage, { type: 'snackbar' } );
 		}

package/src/components/welcome-guide/styles.js

@@ -77,7 +77,7 @@ export default function WelcomeGuideStyles() {
 							</h1>
 							<p className="edit-site-welcome-guide__text">
 								{ __(
-									'You can customize your site as much as you like with different colors, typography, and layouts. Or if you prefer, just leave it up to your theme to handle! '
+									'You can customize your site as much as you like with different colors, typography, and layouts. Or if you prefer, just leave it up to your theme to handle!'
 								) }
 							</p>
 						</>
@@ -117,7 +117,7 @@ export default function WelcomeGuideStyles() {
 							</h1>
 							<p className="edit-site-welcome-guide__text">
 								{ __(
-									'New to block themes and styling your site? '
+									'New to block themes and styling your site?'
 								) }
 								<ExternalLink
 									href={ __(

package/src/hooks/push-changes-to-global-styles/index.js

@@ -26,12 +26,9 @@ import { store as noticesStore } from '@wordpress/notices';
 import { useSupportedStyles } from '../../components/global-styles/hooks';
 import { unlock } from '../../lock-unlock';
 
-const {
-	cleanEmptyObject,
-	GlobalStylesContext,
-	__experimentalUseGlobalBehaviors: useGlobalBehaviors,
-	__experimentalUseHasBehaviorsPanel: useHasBehaviorsPanel,
-} = unlock( blockEditorPrivateApis );
+const { cleanEmptyObject, GlobalStylesContext } = unlock(
+	blockEditorPrivateApis
+);
 
 // Block Gap is a special case and isn't defined within the blocks
 // style properties config. We'll add it here to allow it to be pushed
@@ -286,10 +283,6 @@ function PushChangesToGlobalStylesControl( {
 	attributes,
 	setAttributes,
 } ) {
-	const hasBehaviorsPanel = useHasBehaviorsPanel( attributes, name, {
-		blockSupportOnly: true,
-	} );
-
 	const { user: userConfig, setUserConfig } =
 		useContext( GlobalStylesContext );
 
@@ -299,13 +292,8 @@ function PushChangesToGlobalStylesControl( {
 		useDispatch( blockEditorStore );
 	const { createSuccessNotice } = useDispatch( noticesStore );
 
-	const { inheritedBehaviors, setBehavior } = useGlobalBehaviors( name );
-
-	const userHasEditedBehaviors =
-		attributes.hasOwnProperty( 'behaviors' ) && hasBehaviorsPanel;
-
 	const pushChanges = useCallback( () => {
-		if ( changes.length === 0 && ! userHasEditedBehaviors ) {
+		if ( changes.length === 0 ) {
 			return;
 		}
 
@@ -364,46 +352,15 @@ function PushChangesToGlobalStylesControl( {
 				}
 			);
 		}
-
-		if ( userHasEditedBehaviors ) {
-			__unstableMarkNextChangeAsNotPersistent();
-			setAttributes( { behaviors: undefined } );
-			setBehavior( attributes.behaviors );
-			createSuccessNotice(
-				sprintf(
-					// translators: %s: Title of the block e.g. 'Heading'.
-					__( '%s behaviors applied.' ),
-					getBlockType( name ).title
-				),
-				{
-					type: 'snackbar',
-					actions: [
-						{
-							label: __( 'Undo' ),
-							onClick() {
-								__unstableMarkNextChangeAsNotPersistent();
-								setBehavior( inheritedBehaviors );
-								setUserConfig( () => userConfig, {
-									undoIgnore: true,
-								} );
-							},
-						},
-					],
-				}
-			);
-		}
 	}, [
 		__unstableMarkNextChangeAsNotPersistent,
 		attributes,
 		changes,
 		createSuccessNotice,
-		inheritedBehaviors,
 		name,
 		setAttributes,
-		setBehavior,
 		setUserConfig,
 		userConfig,
-		userHasEditedBehaviors,
 	] );
 
 	return (
@@ -412,7 +369,7 @@ function PushChangesToGlobalStylesControl( {
 			help={ sprintf(
 				// translators: %s: Title of the block e.g. 'Heading'.
 				__(
-					'Apply this block’s typography, spacing, dimensions, color styles, and behaviors to all %s blocks.'
+					'Apply this block’s typography, spacing, dimensions, and color styles to all %s blocks.'
 				),
 				getBlockType( name ).title
 			) }
@@ -422,7 +379,7 @@ function PushChangesToGlobalStylesControl( {
 			</BaseControl.VisualLabel>
 			<Button
 				variant="primary"
-				disabled={ changes.length === 0 && ! userHasEditedBehaviors }
+				disabled={ changes.length === 0 }
 				onClick={ pushChanges }
 			>
 				{ __( 'Apply globally' ) }

package/src/store/actions.js

@@ -4,7 +4,7 @@
 import apiFetch from '@wordpress/api-fetch';
 import { parse, __unstableSerializeAndClean } from '@wordpress/blocks';
 import deprecated from '@wordpress/deprecated';
-import { addQueryArgs, getPathAndQueryString } from '@wordpress/url';
+import { addQueryArgs } from '@wordpress/url';
 import { __, sprintf } from '@wordpress/i18n';
 import { store as noticesStore } from '@wordpress/notices';
 import { store as coreStore } from '@wordpress/core-data';
@@ -233,7 +233,7 @@ export function setHomeTemplateId() {
  *
  * @param {Object} context The context object.
  *
- * @return {number} The resolved template ID for the page route.
+ * @return {Object} Action object.
  */
 export function setEditedPostContext( context ) {
 	return {
@@ -257,22 +257,48 @@ export function setEditedPostContext( context ) {
 export const setPage =
 	( page ) =>
 	async ( { dispatch, registry } ) => {
-		if ( ! page.path && page.context?.postId ) {
-			const entity = await registry
+		let template;
+		const getDefaultTemplate = async ( slug ) =>
+			apiFetch( {
+				path: addQueryArgs( '/wp/v2/templates/lookup', {
+					slug: `page-${ slug }`,
+				} ),
+			} );
+
+		if ( page.path ) {
+			template = await registry
+				.resolveSelect( coreStore )
+				.__experimentalGetTemplateForLink( page.path );
+		} else {
+			const editedEntity = await registry
 				.resolveSelect( coreStore )
-				.getEntityRecord(
+				.getEditedEntityRecord(
 					'postType',
-					page.context.postType || 'post',
-					page.context.postId
+					page.context?.postType || 'post',
+					page.context?.postId
 				);
-			// If the entity is undefined for some reason, path will resolve to "/"
-			page.path = getPathAndQueryString( entity?.link );
+			const currentTemplateSlug = editedEntity?.template;
+			if ( currentTemplateSlug ) {
+				const currentTemplate = (
+					await registry
+						.resolveSelect( coreStore )
+						.getEntityRecords( 'postType', 'wp_template', {
+							per_page: -1,
+						} )
+				)?.find( ( { slug } ) => slug === currentTemplateSlug );
+				if ( currentTemplate ) {
+					template = currentTemplate;
+				} else {
+					// If a page has a `template` set and is not included in the list
+					// of the current theme's templates, query for current theme's default template.
+					template = await getDefaultTemplate( editedEntity?.slug );
+				}
+			} else {
+				// Page's `template` is empty, that indicates we need to use the default template for the page.
+				template = await getDefaultTemplate( editedEntity?.slug );
+			}
 		}
 
-		const template = await registry
-			.resolveSelect( coreStore )
-			.__experimentalGetTemplateForLink( page.path );
-
 		if ( ! template ) {
 			return;
 		}