### Install Sage Directives via Composer

Source: https://github.com/log1x/sage-directives/blob/master/docs/README.md

This command installs the Sage Directives package using Composer, a dependency manager for PHP. Ensure you have Composer installed and configured for your project.

```bash
composer require log1x/sage-directives
```

--------------------------------

### Build Documentation with Yarn

Source: https://github.com/log1x/sage-directives/blob/master/docs/README.md

These commands are used to build the project's documentation. It first installs the necessary Node.js dependencies using Yarn and then executes the documentation build script.

```bash
yarn install
yarn run docs:build
```

--------------------------------

### Echo Field Value with @field Directive (PHP)

Source: https://github.com/log1x/sage-directives/wiki/Advanced-Custom-Fields

The @field directive echoes a specified ACF field value. It supports passing a post ID to retrieve fields from a specific post and an array key to access specific values within an array field. This directive requires ACF to be installed and activated.

```php
@field('text')
@field('text', 1)
@field('image', 'url')
@field('image', 'url', 1)
```

--------------------------------

### Initialize WP_Query with @query Directive

Source: https://github.com/log1x/sage-directives/wiki/WordPress

The @query directive initializes a standard WP_Query object, assigning it to the $query variable. It accepts the usual WP_Query parameters as an array, allowing for flexible post retrieval.

```php
@query([
  'post_type' => 'post'
])
```

--------------------------------

### Flexible Content Layout Handling (@layouts)

Source: https://github.com/log1x/sage-directives/blob/master/docs/usage/acf.md

A helper for managing flexible content fields, similar to @fields. Can retrieve layouts for a specific post by ID. Closes with @endlayouts.

```php
@layouts('components')
  [...]
@endlayouts
```

```php
@layouts('components', 1)
  [...]
@endlayouts
```

--------------------------------

### Inline CSS File Loading with @inline Directive (PHP)

Source: https://github.com/log1x/sage-directives/blob/master/docs/usage/helpers.md

This directive loads the content of a specified CSS file directly into the current view. It assumes the file path is relative to the theme directory. The output will be the raw CSS content, typically intended to be wrapped in a <style> tag by the view.

```php
@inline('dist/styles/critical.css')
```

--------------------------------

### Execute Shortcode with @shortcode Directive

Source: https://github.com/log1x/sage-directives/wiki/WordPress

The @shortcode directive echoes a specified shortcode using the do_shortcode() function, allowing shortcodes to be rendered within the template.

```php
@shortcode('[my-shortcode]')
```

--------------------------------

### Format Content with wpautop using @wpautop Directive

Source: https://github.com/log1x/sage-directives/blob/master/docs/usage/wordpress.md

The @wpautop directive processes a given string through the wpautop() WordPress function, which adds paragraph and line break HTML tags. It then echoes the formatted output.

```php
@wpautop($content)
```

--------------------------------

### Display Post Excerpt with @excerpt Directive

Source: https://github.com/log1x/sage-directives/wiki/WordPress

The @excerpt directive echoes the current post's excerpt using the the_excerpt() function.

```php
@excerpt
```

--------------------------------

### Include WordPress Footer with @wpfooter Directive

Source: https://github.com/log1x/sage-directives/blob/master/docs/usage/wordpress.md

The @wpfooter directive is a direct implementation of the wp_footer() WordPress function, used to output scripts and other content typically placed before the closing </body> tag.

```php
@wpfooter
```

--------------------------------

### Format and Sanitize Content with @wpautokp Directive

Source: https://github.com/log1x/sage-directives/blob/master/docs/usage/wordpress.md

The @wpautokp directive is similar to @wpautop but additionally sanitizes the input string using wp_kses_post(), ensuring only allowed HTML tags are preserved before outputting the result.

```php
@wpautokp($content)
```

--------------------------------

### Inline File Content with @inline

Source: https://context7.com/log1x/sage-directives/llms.txt

Include the content of a file directly into the template. The directive automatically wraps the content with appropriate HTML tags based on the file extension (e.g., `<style>` for CSS, `<script>` for JS, or directly for SVG/HTML).

```php
{{-- Inline critical CSS --}}
@inline('dist/styles/critical.css')

{{-- Inline JavaScript --}}
@inline('dist/scripts/analytics.js')

{{-- Inline HTML/SVG --}}
@inline('dist/images/logo.svg')
```

--------------------------------

### Essential WordPress Template Functions (@wphead / @wpfooter / @wpbodyopen / @bodyclass / @postclass)

Source: https://context7.com/log1x/sage-directives/llms.txt

Provides directives for essential WordPress template functions like outputting head content, footer scripts, body classes, and post classes. These ensure proper WordPress theme structure and functionality. Dependencies include WordPress core functions.

```php
<!DOCTYPE html>
<html>
<head>
  @wphead
</head>
<body @bodyclass('custom-class')>
  @wpbodyopen

  <article @postclass('entry')>
    @content
  </article>

  @wpfooter
</body>
</html>
```

--------------------------------

### Query Posts with WP_Query in Blade

Source: https://context7.com/log1x/sage-directives/llms.txt

Initializes a standard WP_Query and stores the result in the `$query` variable. Accepts all standard WP_Query parameters as an array, allowing for flexible post retrieval.

```php
{{-- Query recent posts --}}
@query([
  'post_type' => 'post',
  'posts_per_page' => 5,
  'orderby' => 'date',
  'order' => 'DESC'
])

{{-- Query custom post type with meta query --}}
@query([
  'post_type' => 'product',
  'posts_per_page' => 10,
  'meta_key' => 'featured',
  'meta_value' => '1'
])
```

--------------------------------

### Execute WordPress Shortcodes (@shortcode)

Source: https://context7.com/log1x/sage-directives/llms.txt

Allows the execution of WordPress shortcodes directly within Blade templates. This directive takes a shortcode string as an argument, enabling the use of existing shortcodes in dynamic ways. Dependencies include registered WordPress shortcodes.

```php
@shortcode('[gallery ids="1,2,3" columns="3"]')
@shortcode('[contact-form-7 id="123" title="Contact Form"]')

{{-- Dynamic shortcode --}}
@shortcode("[embed]{$video_url}[/embed]")
```

--------------------------------

### Display Post Content with @content Directive

Source: https://github.com/log1x/sage-directives/wiki/WordPress

The @content directive echoes the current post's content using the the_content() function.

```php
@content
```

--------------------------------

### Output Theme Customizer Values (@thememod)

Source: https://context7.com/log1x/sage-directives/llms.txt

Outputs values set in the WordPress Theme Customizer. This allows dynamic styling and configuration based on user choices in the customizer interface. It supports default values if a setting is not found. Dependencies include WordPress Theme Customizer settings.

```php
{{-- Simple theme mod --}}
<div style="background-color: @thememod('header_bg_color')">

{{-- With default value --}}
<div style="color: @thememod('text_color', '#333333')">

```

--------------------------------

### Variable Management with @set / @unset / @global

Source: https://context7.com/log1x/sage-directives/llms.txt

Manage template variables. @set assigns values, @unset removes them, and @global accesses WordPress global variables. Essential for dynamic content generation.

```php
{{-- Set a variable --}}
@set($page_title, 'Welcome to our site')
@set($items, ['apple', 'banana', 'orange'])
@set($config, ['show_sidebar' => true, 'columns' => 3])

<h1>{{ $page_title }}</h1>

{{-- Unset when done --}}
@unset($temporary_data)

{{-- Access WordPress globals --}}
@global($post)
<p>Current post: {{ $post->post_title }}</p>
```

--------------------------------

### Include WordPress Head with @wphead Directive

Source: https://github.com/log1x/sage-directives/blob/master/docs/usage/wordpress.md

The @wphead directive is a direct implementation of the wp_head() WordPress function, used to output the content of the <head> section of an HTML document.

```php
@wphead
```

--------------------------------

### Open Body Tag with @wpbodyopen Directive (PHP)

Source: https://github.com/log1x/sage-directives/blob/master/docs/usage/wordpress.md

The @wpbodyopen directive is a compatibility version of WordPress's wp_body_open() function. It ensures functionality on WordPress versions prior to 5.2, allowing for proper hook execution within the body tag.

```php
@wpbodyopen
```

--------------------------------

### Null and Empty Value Checking with @isnull / @isnotnull / @notempty

Source: https://context7.com/log1x/sage-directives/llms.txt

Check if a variable is null or empty. Supports block and inline syntax. Useful for displaying fallback content or conditional messages.

```php
@isnull($user)
  <p>Please log in to continue.</p>
@endisnull

@isnotnull($featured_image)
  <img src="{{ $featured_image }}" />
@endisnotnull

@notempty($items)
  <ul>
    @foreach($items as $item)
      <li>{{ $item }}</li>
    @endforeach
  </ul>
@endnotempty

{{-- Inline syntax --}}
@isnull($value, 'N/A')
@notempty($description, $description)
```

--------------------------------

### Apply WordPress Auto-Paragraph Formatting (@wpautop / @wpautokp)

Source: https://context7.com/log1x/sage-directives/llms.txt

Applies WordPress's automatic paragraph formatting to content, converting line breaks into paragraph tags. `@wpautokp` also includes HTML sanitization for user-submitted content. Dependencies include WordPress formatting functions.

```php
{{-- Add paragraph tags --}}
@wpautop($plain_text_content)

{{-- With HTML sanitization --}}
@wpautokp($user_submitted_content)
```

--------------------------------

### Echo Theme Options with @option

Source: https://github.com/log1x/sage-directives/wiki/Advanced-Custom-Fields

The @option directive echoes a specified theme options field using get_field($field, 'option'). If the option is an array, a key can be passed as a second parameter to retrieve a specific value.

```php
Find us on <a href="@option('facebook_url')" target="_blank">Facebook</a>
```

```php
<div class="navbar-brand">
  <a class="navbar-item" href="{{ home_url() }}">
    <img src="@option('logo', 'url')" alt="{{ get_bloginfo('name', 'display') }}" />
  </a>
</div>
```

--------------------------------

### Compare Theme Options with @isoption

Source: https://github.com/log1x/sage-directives/wiki/Advanced-Custom-Fields

The @isoption directive allows for conditional checking if a theme option field equals a specified value. It is closed using @endoption. For array options, a key can be passed as the second parameter and the value to check against as the third parameter.

```php
@isoption('logo_type', 'image')
  <img src="@option('logo')" alt="{{ get_bloginfo('name', 'display') }}" />
@endoption
```

```php
@isoption('logo', 'type', 'image')
  <img src="@option('logo', 'url')" alt="{{ get_bloginfo('name', 'display') }}" />
@endoption
```

--------------------------------

### Output Images with ACF Integration (@image)

Source: https://context7.com/log1x/sage-directives/llms.txt

Outputs images using WordPress's `wp_get_attachment_image()` function, with automatic detection of ACF image fields. It handles responsive srcset and allows specifying image size, alt text, and custom attributes. Dependencies include ACF plugin and WordPress attachment data.

```php
{{-- By attachment ID --}}
@image(123)
@image(123, 'large')
@image(123, 'full', 'Alt text here')

{{-- With custom attributes --}}
@image(123, 'thumbnail', ['alt' => 'My image', 'class' => 'rounded shadow'])

{{-- Raw URL only --}}
<div style="background-image: url('@image(123, 'raw')')"></div>

{{-- ACF image field (automatically detects) --}}
@image('hero_image')
@image('hero_image', 'full', 'Hero banner')
@image('gallery_image', 'thumbnail', ['class' => 'gallery-thumb'])
```

--------------------------------

### Conditional Theme Options Check with @hasoption

Source: https://github.com/log1x/sage-directives/wiki/Advanced-Custom-Fields

The @hasoption directive provides a conditional check to determine if a theme option field exists and is not empty. It can be closed using @endoption. For array options, a key can be specified as a second parameter. An @else directive can be used for alternative content.

```php
@hasoption('facebook_url')
  Find us on <a href="@option('facebook_url')" target="_blank">Facebook</a>
@endoption
```

```php
@hasoption('facebook', 'url')
  <a href="@option('facebook', 'url')" target="_blank">
    @hasoption('facebook', 'icon')
      <span class="icon">
        <i class="fas @option('facebook', 'icon')"></i>
      </span>
    @else 
      <span class="label">Facebook</span>
    @endoption
  </a>
@endoption
```

--------------------------------

### Echo Comma-Separated Taxonomy Terms with @terms Directive

Source: https://github.com/log1x/sage-directives/blob/master/docs/usage/wordpress.md

The @terms directive echoes a comma-separated list of taxonomy terms for the current post. It accepts similar parameters to the @term directive, allowing for specific post terms and link formatting.

```php
@terms('genre')
@terms('genre', 1)
@terms('genre', 1, true)
@terms('genre', true)
```

--------------------------------

### Asset Inclusion with @stylesheet / @script

Source: https://context7.com/log1x/sage-directives/llms.txt

Include inline styles/scripts or link to external CSS and JavaScript files. Supports both block syntax for inline content and direct paths for external assets.

```php
{{-- Inline CSS --}}
@stylesheet
  .hero {
    background: linear-gradient(to right, #667eea, #764ba2);
    padding: 4rem 2rem;
  }
  .hero h1 {
    color: white;
    font-size: 3rem;
  }
@endstylesheet

{{-- External stylesheet --}}
@stylesheet('/assets/css/custom.css')

{{-- Inline JavaScript --}}
@script
  document.addEventListener('DOMContentLoaded', function() {
    console.log('Page loaded');
    initializeSlider();
  });
@endscript

{{-- External script --}}
@script('/assets/js/custom.js')
```

--------------------------------

### Handling Repeater and Group Fields with Theme Options (@options)

Source: https://github.com/log1x/sage-directives/blob/master/docs/usage/acf.md

The @options directive serves as a helper for iterating over repeater and group fields within theme options. It functions similarly to @fields and @group but automatically includes the theme options ID 'option'. This is essential for rendering dynamic lists or structured data from theme settings.

```php
@hasoptions('social')
  <ul class="social">
    @options('social')
      <li>
        <a href="@sub('url')" target="_blank">
          @hassub('icon')
            <span class="icon">
              <i class="fas fa-@sub('icon')"></i>
            </span>
          @endsub
          <span>@sub('platform')</span>
        </a>
      </li>
    @endoptions
  </ul>
@endhasoptions
```

--------------------------------

### Display Featured Image (Thumbnail) in Blade

Source: https://context7.com/log1x/sage-directives/llms.txt

Outputs the featured image for a post, supporting various sizes and formats. Can return the full `<img>` markup or just the image URL. Accepts post IDs and custom dimensions.

```php
{{-- Basic thumbnail --}}
@thumbnail

{{-- With specific size --}}
@thumbnail('large')
@thumbnail('full')
@thumbnail([800, 600])

{{-- For specific post --}}
@thumbnail(42)
@thumbnail(42, 'medium')

{{-- Get URL only (no img tag) --}}
<div style="background-image: url('@thumbnail(false)')"></div>
<img src="@thumbnail('full', false)" alt="Custom alt text" loading="lazy" />
<img src="@thumbnail(42, 'large', false)" alt="Post 42 image" />
```

--------------------------------

### Retrieve Post Meta with @postmeta Directive

Source: https://github.com/log1x/sage-directives/blob/master/docs/usage/wordpress.md

The @postmeta directive retrieves post meta values using get_post_meta. It requires a 'key' as the first argument and optionally accepts a 'post_id' and a boolean for the '$single' parameter to control the return type. This directive is essential for accessing custom field data.

```php
@postmeta('key')
```

```php
@postmeta('key', 1)
```

```php
@postmeta(1)
```

```php
@postmeta('key', 1, true)
```

--------------------------------

### Handle ACF Flexible Content Fields (@layouts, @layout)

Source: https://context7.com/log1x/sage-directives/llms.txt

Directives for rendering ACF Flexible Content fields. The @layouts directive iterates through available layouts, and @layout specifies the rendering for each specific layout type, allowing for dynamic content structure.

```php
@layouts('page_sections')
  @layout('hero')
    <section class="hero">
      <h1>@sub('heading')</h1>
      <p>@sub('subheading')</p>
      @hassub('background', 'url')
        <img src="@sub('background', 'url')" class="hero-bg" />
      @endsub
    </section>
  @endlayout

  @layout('content_block')
    <section class="content">
      <div class="container">
        @sub('content')
      </div>
    </section>
  @endlayout

  @layout('gallery')
    <section class="gallery">
      @fields('images')
        <figure>
          <img src="@sub('image', 'url')" alt="@sub('caption')" />
          @hassub('caption')
            <figcaption>@sub('caption')</figcaption>
          @endsub
        </figure>
      @endfields
    </section>
  @endlayout

  @layout('cta')
    <section class="cta @sub('style')">
      <h2>@sub('title')</h2>
      <a href="@sub('button_url')" class="btn">@sub('button_text')</a>
    </section>
  @endlayout
@endlayouts
```

--------------------------------

### Display Post Permalink with @permalink Directive

Source: https://github.com/log1x/sage-directives/blob/master/docs/usage/wordpress.md

The @permalink directive echoes the current post's URL using get_permalink(). It can also display the permalink of a specific post by passing its ID or a WP_Post object as a parameter. This directive is used to link to individual posts.

```php
@permalink
```

```php
@permalink(1)
```

```php
@permalink(get_post(1))
```

--------------------------------

### Echo Post Thumbnail with @thumbnail Directive

Source: https://github.com/log1x/sage-directives/blob/master/docs/usage/wordpress.md

The @thumbnail directive echoes the current post's featured image. It accepts a post ID or WP_Post object and an optional size parameter. Passing 'false' as the last parameter returns the image URL instead of the img markup.

```php
@thumbnail
@thumbnail(1)
@thumbnail(get_post(1))
@thumbnail('full')
@thumbnail(1, 'full')
@thumbnail(get_post(1), 'full')
<img src="@thumbnail(false)" alt="My Image" />
<img src="@thumbnail(1, false)" alt="Post 1" />
<img src="@thumbnail(get_post(1), false)" alt="Post 1" />
<img src="@thumbnail('full', false)" alt="Full Image" />
<img src="@thumbnail(1, 'full', false)" alt="Post 1's Full Image" />
<img src="@thumbnail(get_post(1), 'full', false)" alt="Post 1's Full Image" />
```

--------------------------------

### Conditional Field Existence Check (@hassub)

Source: https://github.com/log1x/sage-directives/blob/master/docs/usage/acf.md

Checks if a specified field exists and is not empty. Can handle nested array keys. Closes with @endsub.

```php
@hassub('icon')
  <i class="fas fa-@sub('icon')"></i>
@endsub
```

```php
@hassub('image', 'url')
  <img src="@sub('image', 'url')" alt="@sub('image', 'alt')" />
@endsub
```

```php
@hassub('image', 'sizes', 'thumbnail')
  <img src="@sub('image', 'sizes', 'thumbnail')" alt="@sub('image', 'alt')" />
@endsub
```

--------------------------------

### Display WordPress Navigation Menus (@menu / @hasmenu)

Source: https://context7.com/log1x/sage-directives/llms.txt

Enables the display of WordPress navigation menus within Blade templates. The `@hasmenu` directive checks for the existence of a menu before rendering, ensuring proper output. Dependencies include WordPress menus.

```php
@hasmenu('primary_navigation')
  <nav class="main-nav">
    @menu([
      'theme_location' => 'primary_navigation',
      'container' => false,
      'menu_class' => 'nav-list'
    ])
  </nav>
@endhasmenu
```

--------------------------------

### Handle Theme Options Repeaters/Groups with @options

Source: https://github.com/log1x/sage-directives/wiki/Advanced-Custom-Fields

The @options directive is a helper for managing repeater and group fields within theme options. It functions similarly to @fields and @group but automatically includes the 'option' ID. It is closed using @endoptions.

```php
@hasoption('social')
  <ul class="social">
    @options('social')
      <li>
        <a href="@sub('url')" target="_blank">
          @hassub('icon')
            <span class="icon">
              <i class="fas fa-@sub('icon')"></i>
            </span>
          @endsub
          <span>@sub('platform')</span>
        </a>
      </li>
    @endoptions
  </ul>
@endoption
```

--------------------------------

### Array to String with @implode

Source: https://context7.com/log1x/sage-directives/llms.txt

Join array elements into a single string using a specified separator. This is useful for formatting lists of items, such as tags or categories, into a readable string.

```php
{{-- Basic implode --}}
<p>Tags: @implode(', ', ['php', 'wordpress', 'sage'])</p>

{{-- With variable --}}
<p>Categories: @implode(' | ', $category_names)</p>
```

--------------------------------

### Display WordPress Widget Areas (@sidebar / @hassidebar)

Source: https://context7.com/log1x/sage-directives/llms.txt

Provides directives to display WordPress widget areas (sidebars) and to conditionally render content based on whether a sidebar exists and is populated. This is useful for flexible theme layouts. Dependencies include WordPress widget areas.

```php
{{-- Simple sidebar --}}
@sidebar('sidebar-primary')

{{-- With existence check --}}
@hassidebar('footer-widgets')
  <aside class="footer-widgets">
    @sidebar('footer-widgets')
  </aside>
@endhassidebar
```

--------------------------------

### Display Navigation Menu with @menu Directive (PHP)

Source: https://github.com/log1x/sage-directives/blob/master/docs/usage/wordpress.md

The @menu directive simplifies the output of WordPress navigation menus using wp_nav_menu(). It is commonly paired with @hasmenu and @endhasmenu directives to conditionally display menus based on their existence.

```php
@hasmenu('primary_navigation')
  @menu(['theme_location' => 'primary_navigation'])
@endhasmenu
```

--------------------------------

### User Authentication and Role-Based Content (@role / @user / @guest)

Source: https://context7.com/log1x/sage-directives/llms.txt

Provides directives for conditional content display based on user authentication status and roles. It allows showing content only to logged-in users, guests, or users with specific administrator roles. Dependencies include WordPress user authentication system.

```php
{{-- Content for logged-in users --}}
@user
  <nav class="user-menu">
    <a href="/dashboard">Dashboard</a>
    <a href="{{ wp_logout_url() }}">Logout</a>
  </nav>
@enduser

{{-- Content for guests --}}
@guest
  <div class="login-prompt">
    <a href="{{ wp_login_url() }}">Log in</a> to access your account.
  </div>
@endguest

{{-- Role-specific content --}}
@role('administrator')
  <a href="/wp-admin">Admin Panel</a>
@endrole

@role('editor', 'administrator')
  <a href="/wp-admin/edit.php">Manage Posts</a>
@endrole

@role('subscriber')
  <p>Upgrade your account for more features.</p>
@endrole
```

--------------------------------

### Output Taxonomy Terms (@category / @categories / @term / @terms)

Source: https://context7.com/log1x/sage-directives/llms.txt

Outputs taxonomy terms for posts, with options for single terms, multiple terms, and creating links to terms. It supports custom taxonomies and can retrieve terms for specific posts. Dependencies include WordPress taxonomy data.

```php
{{-- Single category (first one) --}}
<span class="category">@category</span>

{{-- Category as link --}}
<span class="category">@category(true)</span>

{{-- All categories as comma-separated list --}}
<div class="categories">@categories</div>

{{-- Categories as links --}}
<div class="categories">@categories(true)</div>

{{-- For specific post --}}
@category(42)
@categories(42, true)

{{-- Custom taxonomies --}}
<span class="genre">@term('genre')</span>
<span class="genres">@terms('genre')</span>

{{-- Terms as links --}}
@term('genre', true)
@terms('genre', 42, true)
```

--------------------------------

### Output Post Data in Blade

Source: https://context7.com/log1x/sage-directives/llms.txt

Directives for outputting common post data such as title, content, excerpt, and permalink. These can be used within a loop or with a specific post ID or object.

```php
{{-- Basic usage in post loop --}}
@posts
  <article>
    <h1>@title</h1>
    <div class="content">@content</div>
    <div class="summary">@excerpt</div>
    <a href="@permalink" class="read-more">Continue Reading</a>
  </article>
@endposts

{{-- Get data from specific posts --}}
<h2>Featured: @title(42)</h2>
<a href="@permalink(42)">View Post</a>

{{-- Using post object --}}
@php $featured_post = get_post(99); @endphp
<div class="featured">
  <h3>@title($featured_post)</h3>
  <a href="@permalink($featured_post)">Learn More</a>
</div>
```

--------------------------------

### Looping: @repeat directive in PHP

Source: https://github.com/log1x/sage-directives/blob/master/docs/usage/helpers.md

The @repeat directive repeats its content a specified number of times, providing a $loop variable with iteration details similar to native loops.

```php
<ul>
  @repeat(5)
    <li>{{ $loop->iteration }}</li>
  @endrepeat
</ul>
```

```php
@repeat(5)
  @if ($loop->first)
    This is the first iteration.
  @endif

  @if ($loop->last)
    This is the last iteration.
  @endif

  This is iteration {{ $loop->iteration }} out of $loop->count.
  There are {{ $loop->remaining }} iterations left.
  The current iteration index is {{ $loop->index }}
@endrepeat
```

--------------------------------

### Echo Post Author URL with @authorurl Directive

Source: https://github.com/log1x/sage-directives/blob/master/docs/usage/wordpress.md

The @authorurl directive echoes the archive URL of the current post's author. It can also echo the URL for a specific author by passing the author's ID as a parameter.

```php
<span class="author" itemprop="author" itemscope itemtype="http://schema.org/Person">
  <a href="@authorurl" itemprop="url">
    <span class="fn" itemprop="name" rel="author">@author</span>
  </a>
</span>
<a href="@authorurl(2)">@author</a>
```

--------------------------------

### Conditional Content for Guests with @guest Directive

Source: https://github.com/log1x/sage-directives/wiki/WordPress

The @guest directive provides a conditional block for content that should only be visible to users who are not logged in, based on the !is_user_logged_in() function. The block is closed with @endguest.

```php
@guest
  You must be <a href="/wp-login.php">logged in</a> to view this content.
@endguest
```

--------------------------------

### Conditional Display: @notempty directive in PHP

Source: https://github.com/log1x/sage-directives/blob/master/docs/usage/helpers.md

The @notempty directive conditionally displays content if the provided variable is not empty. It can be closed with @endnotempty or by passing the output as a second parameter.

```php
@notempty($variable)
  There is something here.
@endnotempty
```

```php
@notempty($variable, 'There is something here.')
```

--------------------------------

### Content Repetition with @repeat

Source: https://context7.com/log1x/sage-directives/llms.txt

Repeat a block of content a specified number of times. Provides access to the `$loop` variable, which contains properties like `iteration` and `count`, enabling dynamic content generation within loops.

```php
{{-- Star rating --}}
<div class="rating">
  @repeat(5)
    <span class="star {{ $loop->iteration <= $rating ? 'filled' : '' }}"></span>
  @endrepeat
</div>

{{-- Skeleton loader --}}
<ul class="skeleton-list">
  @repeat(3)
    <li class="skeleton-item">
      <div class="skeleton-avatar"></div>
      <div class="skeleton-text"></div>
    </li>
  @endrepeat
</ul>

{{-- With loop properties --}}
@repeat(5)
  @if($loop->first)
    <span class="first-item">First</span>
  @endif

  <span>Item {{ $loop->iteration }} of {{ $loop->count }}</span>

  @if($loop->last)
    <span class="last-item">Last</span>
  @endif
@endrepeat
```

--------------------------------

### Echo Post Category with @category Directive

Source: https://github.com/log1x/sage-directives/blob/master/docs/usage/wordpress.md

The @category directive echoes the first category of the current post. It can display the category as a link by passing 'true' as a parameter. It also supports displaying the category of a specific post by passing the post ID.

```php
@category
@category(true)
@category(1)
@category(1, true)
```

--------------------------------

### Type Checking Conditionals with @instanceof / @typeof

Source: https://context7.com/log1x/sage-directives/llms.txt

Perform type checking on variables. @instanceof checks object types, while @typeof checks scalar types or arrays. Useful for rendering specific content based on data types.

```php
@instanceof($post, 'WP_Post')
  <article id="post-{{ $post->ID }}">
    {{ $post->post_title }}
  </article>
@endinstanceof

@typeof($count, 'integer')
  <span>Count: {{ $count }}</span>
@endtypeof

@typeof($data, 'array')
  @foreach($data as $item)
    {{ $item }}
  @endforeach
@endtypeof
```

--------------------------------

### Handle Flexible Content Fields with @layouts

Source: https://github.com/log1x/sage-directives/wiki/Advanced-Custom-Fields

The @layouts directive is a helper for managing flexible content fields, acting as an alias for @fields. It allows for cleaner code when used with @layout and can be closed with @endlayouts. It can optionally retrieve layouts for a specific post by passing a post ID as a second parameter.

```php
@layouts('components')
  [...] 
@endlayouts
```

```php
@layouts('components', 1)
  [...] 
@endlayouts
```

--------------------------------

### Echo Taxonomy Term with @term Directive

Source: https://github.com/log1x/sage-directives/blob/master/docs/usage/wordpress.md

The @term directive echoes the taxonomy term of the current post. It can display the first term if multiple exist, or terms for a specific post. It also supports returning terms as links.

```php
@term('genre')
@term('genre', 1)
@term('genre', 1, true)
@term('genre', true)
```

--------------------------------

### Echo Image with @image Directive

Source: https://github.com/log1x/sage-directives/blob/master/docs/usage/wordpress.md

The @image directive echoes an image using wp_get_attachment_image(). It supports ACF fields, custom image sizes, alt tags, and returning raw attachment URLs. It can also accept an array for image tag attributes.

```php
@image(1)
@image(1, 'full', 'My alt tag')
<img src="@image(1, 'raw')" alt="Take that, WordPress." />
@image(1, 'thumbnail', ['alt' => 'My alt tag', 'class' => 'block w-32 h-32'])
@image('my_image_field')
@image('my_image_field', 'full', 'My alt tag')
@image('my_image_field', 'thumbnail', ['alt' => 'My alt tag', 'class' => 'block w-32 h-32'])
<img src="@image('my_image_field', 'raw')" alt="My alt tag" />
```

--------------------------------

### Echo Post Categories with @categories Directive

Source: https://github.com/log1x/sage-directives/blob/master/docs/usage/wordpress.md

The @categories directive echoes a comma-separated list of the current post's categories. It can display categories as links by passing 'true' as a parameter. It also supports displaying categories for a specific post by passing the post ID.

```php
@categories
@categories(1)
@categories(true)
@categories(1, true)
```

--------------------------------

### Variable Management: @global directive in PHP

Source: https://github.com/log1x/sage-directives/blob/master/docs/usage/helpers.md

The @global directive makes a specified variable available in the current scope.

```php
@global($post)
```

--------------------------------

### Asset Management: @stylesheet directive in PHP

Source: https://github.com/log1x/sage-directives/blob/master/docs/usage/helpers.md

The @stylesheet directive allows for inlining CSS or linking to external stylesheets. Inline CSS blocks can be closed with @endstyle.

```php
@stylesheet
  .button {
    background-color: LightGreen;
    color: white;
    padding: 0.75rem 1rem;
  }
@endstylesheet
```

```php
@stylesheet('/path/to/style.css')
```

--------------------------------

### Conditional Display with @istrue / @isfalse

Source: https://context7.com/log1x/sage-directives/llms.txt

Conditionally display content based on boolean values. Supports both block and inline syntax. No external dependencies required.

```php
{{-- Block syntax --}}
@istrue($show_sidebar)
  <aside class="sidebar">
    @sidebar('main-sidebar')
  </aside>
@endistrue

@isfalse($is_premium_user)
  <div class="upgrade-banner">
    Upgrade to Premium for more features!
  </div>
@endisfalse

{{-- Inline syntax --}}
@istrue($has_discount, '<span class="badge">Sale!</span>')
@isfalse($in_stock, '<span class="out-of-stock">Out of Stock</span>')
```

--------------------------------

### Display Post Title with @title Directive

Source: https://github.com/log1x/sage-directives/wiki/WordPress

The @title directive echoes the current post's title using get_the_title(). It can optionally accept a post ID as a parameter to display the title of a specific post.

```php
@title
```

```php
@title(1)
```

--------------------------------

### Access ACF Options Page Fields (@option, @hasoption, @options)

Source: https://context7.com/log1x/sage-directives/llms.txt

Directives for retrieving data from ACF Options Pages. Supports outputting single options, checking for their existence, and looping through option repeaters. Essential for site-wide settings and configurations.

```php
{{-- Simple option --}}
<footer>
  <p>@option('copyright_text')</p>
</footer>

{{-- Array option --}}
<img src="@option('site_logo', 'url')" alt="@option('site_logo', 'alt')" />

{{-- Conditional option --}}
@hasoption('facebook_url')
  <a href="@option('facebook_url')">Facebook</a>
@endoption

{{-- Loop through option repeater --}}
@hasoptions('social_links')
  <ul class="social-links">
    @options('social_links')
      <li>
        <a href="@sub('url')" target="_blank">
          @hassub('icon')
            <i class="@sub('icon')"></i>
          @endsub
          @sub('label')
        </a>
      </li>
    @endoptions
  </ul>
@endhasoptions
```

--------------------------------

### Output Author Name and URL in Blade

Source: https://context7.com/log1x/sage-directives/llms.txt

Directives for outputting the current post author's display name (`@author`) and their archive URL (`@authorurl`). Can also be used with a specific author ID.

```php
<article>
  <header>
    <h2>@title</h2>
    <div class="byline">
      Written by <a href="@authorurl">@author</a>
    </div>
  </header>
</article>

{{-- Specific author by ID --}}
<div class="author-box">
  <a href="@authorurl(3)">@author(3)</a>
</div>
```

--------------------------------

### Output Post Dates with Customizable Formatting (@published / @modified)

Source: https://context7.com/log1x/sage-directives/llms.txt

Outputs post publication and modification dates with customizable formatting options. It supports default WordPress date formatting, custom formats, Schema.org markup, and specific post retrieval by ID. Dependencies include WordPress date settings.

```php
{{-- Default date format (from WordPress settings) --}}
<time>@published</time>

{{-- Custom date formats --}}
<time datetime="@published('c')">@published('F j, Y')</time>

{{-- Schema.org markup --}}
<article itemscope itemtype="http://schema.org/Article">
  <time itemprop="datePublished" datetime="@published('c')">
    @published('F j, Y')
  </time>
  <time itemprop="dateModified" datetime="@modified('c')">
    Updated: @modified('F j, Y')
  </time>
</article>

{{-- For specific post --}}
<span>Published: @published('M j, Y', 42)</span>
```

--------------------------------

### Variable Management: @set directive in PHP

Source: https://github.com/log1x/sage-directives/blob/master/docs/usage/helpers.md

The @set directive assigns a value to a specified variable.

```php
@set($hello, 'world')
```

--------------------------------

### Apply WordPress Filter with @filter Directive

Source: https://github.com/log1x/sage-directives/blob/master/docs/usage/wordpress.md

The @filter directive echoes the result of applying a WordPress filter hook to a given value using the apply_filters() function. It requires the filter name and the value to be filtered.

```php
@filter('the_content', 'some string')
```

--------------------------------

### Output and Check ACF Fields (@field, @hasfield, @isfield)

Source: https://context7.com/log1x/sage-directives/llms.txt

Directives for displaying ACF field values, checking their existence, and comparing their values. Supports basic fields, array fields, and fields from specific posts. Useful for conditional rendering based on field presence or value.

```php
{{-- Basic field output --}}
<h1>@field('page_title')</h1>
<div>@field('description')</div>

{{-- Array field (image return format: array) --}}
<img src="@field('image', 'url')" alt="@field('image', 'alt')" />

{{-- Field from specific post --}}
<h2>@field('headline', 42)</h2>

{{-- Conditional display --}}
@hasfield('subtitle')
  <h2 class="subtitle">@field('subtitle')</h2>
@endfield

{{-- Check array field --}}
@hasfield('featured_image', 'url')
  <img src="@field('featured_image', 'url')" />
@endfield

{{-- Value comparison --}}
@isfield('layout_type', 'full-width')
  <div class="container-fluid">
@endfield

@isfield('status', 'published')
  <span class="badge">Live</span>
@endfield
```

--------------------------------

### Loop Through Posts with @posts Directive

Source: https://github.com/log1x/sage-directives/wiki/WordPress

The @posts directive initiates a post loop, defaulting to the $query variable set by @query. It's wrapped in a have_posts() conditional and can be closed with @endposts, which also resets post data. It supports passing a WP_Query instance, a single post ID or object, or an array of IDs/objects.

```php
@query([
  'post_type' => 'post'
])

@posts
  <h2 class="entry-title">@title</h2>
  <div class="entry-content">
    @content
  </div>
@endposts
```

```php
@php
  $query = new WP_Query([
    'post_type' => 'post'
  ]);
@endphp

@posts($query)
  <h2 class="entry-title">@title</h2>
  <div class="entry-content">
    @content
  </div>
@endposts
```

```php
@posts(12)
  <h2 class="entry-title">@title</h2>
  <div class="entry-content">
    @content
  </div>
@endposts
```

```php
@posts(get_post(4))
  <h2 class="entry-title">@title</h2>
  <div class="entry-content">
    @content
  </div>
@endposts
```

```php
@posts([6, get_post(9), 3])
  <h2 class="entry-title">@title</h2>
  <div class="entry-content">
    @content
  </div>
@endposts
```

--------------------------------

### Conditional Content by User Role with @role Directive

Source: https://github.com/log1x/sage-directives/blob/master/docs/usage/wordpress.md

The @role directive displays content only to logged-in users with specific roles. It automatically lowercases the provided role names for comparison with the user's roles. Content is enclosed by @endrole.

```php
@role('author')
  This content is only displayed to Authors.
@endrole

@role('author', 'contributor')
  This content is only displayed to Authors and Contributors.
@endrole
```

--------------------------------

### Echo Post Author Display Name with @author Directive

Source: https://github.com/log1x/sage-directives/blob/master/docs/usage/wordpress.md

The @author directive echoes the display name of the current post's author. It can also display the author of a specific post by passing the author's ID as a parameter.

```php
@author
@author(1)
```

--------------------------------

### Display Sidebar with @sidebar and Conditional Logic (PHP)

Source: https://github.com/log1x/sage-directives/blob/master/docs/usage/wordpress.md

The @sidebar directive displays a dynamic sidebar, equivalent to WordPress's dynamic_sidebar() function. It is often used with @hassidebar and @endhassidebar directives, which check sidebar activity using is_active_sidebar().

```php
@sidebar('sidebar-primary')

@hassidebar('sidebar-primary')
  @sidebar('sidebar-primary')
@endhassidebar
```

--------------------------------

### Trigger WordPress Action with @action Directive

Source: https://github.com/log1x/sage-directives/blob/master/docs/usage/wordpress.md

The @action directive allows triggering a WordPress action hook directly within the template using the do_action() function. It takes the action name as its primary argument.

```php
@action('get_footer')
```

--------------------------------

### Trigger WordPress Hooks and Filters (@action / @filter)

Source: https://context7.com/log1x/sage-directives/llms.txt

Allows triggering WordPress actions and applying filters directly within Blade templates. This facilitates integration with WordPress hooks for custom functionality and content manipulation. Dependencies include WordPress hooks.

```php
{{-- Trigger actions --}}
@action('get_header')
@action('my_custom_action', $post->ID)

{{-- Apply filters --}}
<div class="content">
  @filter('the_content', $raw_content)
</div>
```

--------------------------------

### Loop Through Posts in Blade

Source: https://context7.com/log1x/sage-directives/llms.txt

Begins a post loop, providing access to the `$loop` variable and standard post data directives. It can accept results from `@query`, WP_Query instances, post IDs, objects, or arrays. Automatically calls `wp_reset_postdata()` upon closing.

```php
{{-- Basic post loop with @query --}}
@query(['post_type' => 'post', 'posts_per_page' => 3])
@posts
  <article class="{{ $loop->first ? 'featured' : '' }}">
    <h2>@title</h2>
    <div class="meta">
      <span class="author">By @author</span>
      <time>@published('F j, Y')</time>
    </div>
    <div class="excerpt">@excerpt</div>
    <a href="@permalink">Read more</a>
  </article>
@endposts

{{-- Loop through specific posts by ID --}}
@posts([12, 45, 78])
  <div class="card">
    <h3>@title</h3>
    @thumbnail('medium')
  </div>
@endposts

{{-- Pass custom WP_Query instance --}}
@php
  $featured = new WP_Query([
    'post_type' => 'portfolio',
    'posts_per_page' => 6
  ]);
@endphp
@posts($featured)
  <div class="portfolio-item">
    @thumbnail('large')
    <h4>@title</h4>
  </div>
@endposts
```

--------------------------------

### Retrieve Post Meta Values (@postmeta)

Source: https://context7.com/log1x/sage-directives/llms.txt

Retrieves post meta (custom field) values. It supports fetching meta for the current post or a specific post by ID, and can return a single value or all values. Dependencies include WordPress post meta data.

```php
{{-- Current post meta --}}
@postmeta('custom_field')

{{-- Specific post --}}
@postmeta('custom_field', 42)

{{-- Single value --}}
@postmeta('custom_field', 42, true)
```

--------------------------------

### Conditional Layouts with @layout

Source: https://github.com/log1x/sage-directives/wiki/Advanced-Custom-Fields

The @layout directive checks if get_row_layout() matches a specified value within a have_rows() loop. This, combined with @layouts, enables clean display of flexible content components. It is closed using @endlayout.

```php
@layouts('components')
  @layout('card')
    <div class="card">
      @hassub('image')
        <div class="card-image">
          <img src="@sub('image', 'url')" alt="@sub('image', 'alt')" />
        </div>
      @endsub

      <div class="card-content">
        <h2>@sub('title')</h2>
        @sub('description')
      </div>
    </div>
  @endlayout

  @layout('button')
    @hassub('url')
      <a href="@sub('url')" class="button button--@sub('color') button--@sub('size')">
        @hassub('icon')
          <i class="fa fa-@sub('icon')"></i>
        @endsub
        <span>@sub('label')</span>
      </a>
    @endsub
  @endlayout

  @layout('content')
    @hassub('content')
      <div class="content">
        @sub('content')
      </div>
    @endsub
  @endlayout
@endlayouts
```

--------------------------------

### Conditional Field Value Check (@issub)

Source: https://github.com/log1x/sage-directives/blob/master/docs/usage/acf.md

Checks if a subfield matches a specified value. Can handle nested array keys and values. Closes with @endsub.

```php
@issub('icon', 'arrow')
  <i class="fas fa-arrow-up fa-rotate-90"></i>
@endsub
```

```php
@issub('icon', 'name', 'arrow')
  <i class="fas fa-@sub('icon', 'value') fa-rotate-90"></i>
@endsub
```

--------------------------------

### Conditional Display: @isnotnull directive in PHP

Source: https://github.com/log1x/sage-directives/blob/master/docs/usage/helpers.md

The @isnotnull directive conditionally displays content if the provided variable is not null. It can be closed with @endisnotnull or by passing the output as a second parameter.

```php
@isnotnull($variable)
  There is something here.
@endisnotnull
```

```php
@isnotnull($variable, 'There is something here.')
```

--------------------------------

### Type Checking: @instanceof directive in PHP

Source: https://github.com/log1x/sage-directives/blob/master/docs/usage/helpers.md

The @instanceof directive checks if the first parameter is an instance of the class specified by the second parameter. It can be closed with @endinstanceof.

```php
@instanceof($post, 'WP_Post')
  The post ID is {{ $post->ID }}.
@endinstanceof
```

--------------------------------

### Add Post Classes with @postclass Directive (PHP)

Source: https://github.com/log1x/sage-directives/blob/master/docs/usage/wordpress.md

The @postclass directive applies CSS classes to post elements, mirroring the functionality of WordPress's post_class() function. It can accept an optional CSS class name and a post ID to specify which post to apply the classes to.

```php
@postclass
@postclass('bg-white')
@postclass('bg-white', $post->ID)
```

--------------------------------

### Conditional Post Existence Checks in Blade

Source: https://context7.com/log1x/sage-directives/llms.txt

Conditionally displays content based on whether posts exist. `@hasposts` wraps content shown when posts are found, while `@noposts` provides content for empty states. Often used in conjunction with `@query`.

```php
{{-- Display posts only if they exist --}}
@query(['post_type' => 'event', 'posts_per_page' => 5])

@hasposts
  <ul class="events-list">
    @posts
      <li>
        <a href="@permalink">@title</a>
        <span>@published('M j')</span>
      </li>
    @endposts
  </ul>
@endhasposts

@noposts
  <div class="no-events">
    <p>No upcoming events scheduled.</p>
    <a href="/contact">Contact us to schedule an event</a>
  </div>
@endnoposts
```

--------------------------------

### Conditional Content for Logged-in Users with @user Directive

Source: https://github.com/log1x/sage-directives/wiki/WordPress

The @user directive acts as a conditional block, displaying its content only when a user is logged in, utilizing the is_user_logged_in() function. The block is closed with @enduser.

```php
@user
  You are logged in!
@enduser
```

--------------------------------

### Asset Management: @script directive in PHP

Source: https://github.com/log1x/sage-directives/blob/master/docs/usage/helpers.md

The @script directive allows for inlining JavaScript or linking to external script files. Inline JS blocks can be closed with @endscript.

```php
@script
  console.log('Hello World')
@endscript
```

```php
@script('/path/to/script.js')
```