enhance(directives): Add a @sidebar, @hassidebar, and @endhassidebar directive (Fixes #71) (#92)

Author: Log1x

docs/usage/wordpress.md

@@ -519,3 +519,17 @@ This is a directive version of [`wp_body_open`](https://developer.wordpress.org/
 @postclass('bg-white')
 @postclass('bg-white', $post->ID)
 ```
+
+## @sidebar
+
+`@sidebar` is a simply directive that calls [`dynamic_sidebar`](https://developer.wordpress.org/reference/functions/dynamic_sidebar/).
+
+It comes with two assisting directives `@hassidebar` and `@endhassidebar` that checks for the existence of the sidebar using [`is_active_sidebar`](https://developer.wordpress.org/reference/functions/is_active_sidebar/).
+
+```php
+@sidebar('sidebar-primary')
+
+@hassidebar('sidebar-primary')
+  @sidebar('sidebar-primary')
+@endhassidebar
+```

src/Directives/WordPress.php

@@ -582,6 +582,24 @@
         return "<?php post_class({$expression}); ?>";
     },
 
+    /*
+    |---------------------------------------------------------------------
+    | @sidebar / @hassidebar / @endhassidebar
+    |---------------------------------------------------------------------
+    */
+
+    'sidebar' => function ($expression) {
+        return "<?php dynamic_sidebar($expression); ?>";
+    },
+
+    'hassidebar' => function ($expression) {
+        return "<?php if (is_active_sidebar($expression)) : ?>";
+    },
+
+    'endhassidebar' => function () {
+        return '<?php endif; ?>';
+    },
+
     /*
     |---------------------------------------------------------------------
     | @__

tests/Unit/WordPressTest.php

@@ -764,6 +764,36 @@
     });
 });
 
+describe('@sidebar', function () {
+    it('compiles correctly', function () {
+        $directive = "@sidebar('sidebar-1')";
+
+        $compiled = $this->compile($directive);
+
+        expect($compiled)->toBe("<?php dynamic_sidebar('sidebar-1'); ?>");
+    });
+});
+
+describe('@hassidebar', function () {
+    it('compiles correctly', function () {
+        $directive = "@hassidebar('sidebar-1')";
+
+        $compiled = $this->compile($directive);
+
+        expect($compiled)->toBe("<?php if (is_active_sidebar('sidebar-1')) : ?>");
+    });
+});
+
+describe('@endhassidebar', function () {
+    it('compiles correctly', function () {
+        $directive = '@endhassidebar';
+
+        $compiled = $this->compile($directive);
+
+        expect($compiled)->toBe('<?php endif; ?>');
+    });
+});
+
 describe('@__', function () {
     it('compiles correctly', function () {
         $directive = "@__('Hello World', 'sage')";