[#11] Using Timber/Twig (#12)

* [#11] Using Timber/Twig

* [N/A] PR Template

Author: bd-viget

.github/pull_request_template.md

@@ -0,0 +1,15 @@
+# Summary
+
+<!-- Brief Description of what this PR does. -->
+
+## Issues
+
+* List any related issues.
+
+## Testing Instructions
+
+1. List out testing instructions
+
+## Screenshots
+
+<!-- Optional -->

wp-content/plugins/acf-blocks-toolkit/acf-blocks-toolkit.php

@@ -41,5 +41,8 @@
 // Settings functions.
 require_once 'includes/settings.php';
 
+// Timber functions.
+require_once 'includes/timber.php';
+
 Block_Registration::init();
 Settings::init();

wp-content/plugins/acf-blocks-toolkit/includes/helpers.php

@@ -261,11 +261,12 @@ function get_field_property( string $selector, string $property, string $group_i
 	 *
 	 * @since 1.0.0
 	 *
-	 * @param array $props
-	 *    @param array  allowedBlocks Allowed blocks
-	 *    @param array  template      Block Template
-	 *    @param string templateLock  Template Lock
-	 *    @param string className     Class Name
+	 * @param array $props {
+	 *    @type array  $allowedBlocks Allowed blocks
+	 *    @type array  $template      Block Template
+	 *    @type string $templateLock  Template Lock
+	 *    @type string $className     Class Name
+	 * }
 	 *
 	 * @return void
 	 */

wp-content/plugins/acf-blocks-toolkit/includes/register.php

@@ -7,16 +7,13 @@
 
 namespace Viget\ACFBlocksToolkit;
 
+use Timber\Timber;
+
 /**
  * Block Registration Class
  */
 class Block_Registration {
 
-	/**
-	 * @var string
-	 */
-//	const ALL_BLOCKS_TRANSIENT = 'acfbt_all_blocks';
-
 	/**
 	 * @var array
 	 */
@@ -73,7 +70,7 @@ function ( array $metadata ): array {
 					return $metadata;
 				}
 
-				$metadata['acf']['renderCallback'] = function ( array $block ): void {
+				$metadata['acf']['renderCallback'] = function ( array $block, string $content = '', bool $is_preview = false ): void {
 					$block_name    = str_replace( 'acf/', '', $block['name'] );
 					$block['slug'] = sanitize_title( $block_name );
 					if ( empty( $block['path'] ) ) {
@@ -82,6 +79,14 @@ function ( array $metadata ): array {
 					if ( empty( $block['url'] ) ) {
 						$block['url'] = self::path_to_url( $block['path'] );
 					}
+
+					$twig = $block['path'] . '/render.twig';
+
+					if ( class_exists( '\Timber\Timber' ) && file_exists( $twig ) ) {
+						self::render_twig_block( $twig, $block, $content, $is_preview );
+						return;
+					}
+
 					$render = $block['path'] . '/render.php';
 
 					if ( ! file_exists( $render ) ) {
@@ -96,7 +101,6 @@ function ( array $metadata ): array {
 				};
 
 				return $metadata;
-
 			},
 			5
 		);
@@ -112,21 +116,16 @@ public static function get_all_blocks(): array {
 			return self::$blocks;
 		}
 
-//		$transient = get_transient( self::ALL_BLOCKS_TRANSIENT );
-//		if ( $transient ) {
-//			self::$blocks = $transient;
-//			return $transient;
-//		}
-
 		$locations = self::get_block_locations();
 
 		foreach ( $locations as $location ) {
+			if ( ! is_dir( $location ) ) {
+				continue;
+			}
+
 			self::get_blocks_in_dir( $location, self::$blocks );
 		}
 
-		// Cache for 30min
-//		set_transient( ALL_BLOCKS_TRANSIENT, self::$blocks, MINUTE_IN_SECONDS * 30 );
-
 		return self::$blocks;
 	}
 
@@ -268,4 +267,33 @@ function ( bool $wrap, string $name ): bool {
 			2
 		);
 	}
+
+	/**
+	 * Render Twig block
+	 *
+	 * @param string $template
+	 * @param array  $block
+	 * @param string $content
+	 * @param bool   $is_preview
+	 *
+	 * @return void
+	 */
+	public static function render_twig_block( string $template, array $block = [], string $content = '', bool $is_preview = false, int $post_id = 0 ): void {
+		$context = Timber::context();
+
+		// Store block attributes.
+		$context['attributes'] = $block;
+
+		// Store field values. These are the fields from your ACF field group for the block.
+		$context['fields'] = get_fields();
+
+		// Store whether the block is being rendered in the editor or on the frontend.
+		$context['is_preview'] = $is_preview;
+
+		// Store the current post ID.
+		$context['post_id'] = $post_id;
+
+		// Render the block.
+		Timber::render( $template, $context );
+	}
 }

wp-content/plugins/acf-blocks-toolkit/includes/timber.php

@@ -0,0 +1,30 @@
+<?php
+/**
+ * Timber Integration
+ *
+ * @package ACFBlocksToolkit
+ */
+
+add_action(
+	'after_setup_theme',
+	function () {
+		if ( ! class_exists( 'Timber\Timber' ) ) {
+			return;
+		}
+
+		add_filter(
+			'timber/twig/functions',
+			function ( array $functions ): array {
+				$functions['inner_blocks'] = [
+					'callable' => 'inner_blocks',
+				];
+				$functions['block_attrs'] = [
+					'callable' => 'block_attrs',
+				];
+
+				return $functions;
+			}
+		);
+
+	}
+);

wp-content/themes/wp-starter/blocks/cta/render.twig

@@ -0,0 +1,16 @@
+{#
+  Block: CTA
+#}
+
+{% set template = [
+  [
+    'core/pattern',
+    {
+      'slug': 'wp-starter/cta-dynamic'
+    }
+  ]
+] %}
+{% set inner = { template: template } %}
+<section {{ block_attrs( attributes ) }}>
+  {{ inner_blocks( inner ) }}
+</section>

wp-content/themes/wp-starter/composer.json

@@ -1,5 +1,11 @@
 {
     "require": {
-        "idleberg/wordpress-vite-assets": "^1.0"
+        "idleberg/wordpress-vite-assets": "^1.0",
+        "timber/timber": "^2.1"
+    },
+    "config": {
+        "allow-plugins": {
+            "composer/installers": true
+        }
     }
-}
+}