awesome9/templates

Wrapper for WordPress Filesystem and Templates.

1.0.4 2021-07-10 02:26 UTC

This package is auto-updated.

Last update: 2024-10-10 09:30:27 UTC


README

Awesome9 Codacy Badge Latest Stable Version PHP from Packagist Total Downloads License

📃 About Template

This package provides ease of loading templates intended to be used within a plugin or theme and also provide a template system like WooCommerce.

The inspiration for the package comes from Templates micropackage.

💾 Installation

composer require awesome9/templates

🕹 Usage

First, you need to initialize your storage.

Awesome9\Templates\Storage::get()
	->set_basedir( dirname( __FILE__ ) )
	->set_baseurl( plugins_url( __FILE__ ) );

Case # 1: Random folders

Let's assume your template tree looks like this:

my-plugin/
├── admin/
│   └── templates/
│      ├── notice.php
│      └── settings.php
└── frontend/
	└── templates/
	   ├── profile.php
	   └── welcome.php

In the above case we have two places with templates, let's define them as storages.

Awesome9\Templates\Storage::get()->add( 'admin', 'admin/templates' );
Awesome9\Templates\Storage::get()->add( 'frontend', 'frontend/templates' );

Then you can easily render template:

$template = new Awesome9\Templates\Template( 'frontend', 'author', [
	'author' => $user_name,
	'posts'  => get_posts( [ 'author' => $user_id ] ),
] );

$template->render();

The template file could look like this:

<p>Howdy, <?php $this->the( 'author' ); ?></p>

<p>Posts by Author:</p>

<ul>
	<?php foreach ( $this->get( 'posts' ) as $post ) : ?>
		<li><?php echo $post->post_title; ?></li>
	<?php endforeach; ?>
</ul>

Case # 2: Template from theme first

Let's assume your template tree looks like this:

my-plugin/
├── templates/
│   ├── notice.php
│   └── profile.php

some-theme/
├── my-plugin/
│   ├── notice.php
│   └── settings.php

In this case, we set both plugin and theme folder name for template lookup.

Awesome9\Templates\Storage::get()->set_for_theme( 'templates', 'my-plugin' );

Accessing variables in the template file

In the template file, $this points to the template instance, which means you can access all the template methods.

The basic usage is:

$this->the( 'var_name' ); // Prints the value.
$var_name = $this->get( 'var_name' ); // Gets the value.

But you can also use the shorthand closure methods:

$the( 'var_name' ); // Prints the value.
$var_name = $get( 'var_name' ); // Gets the value.

Default variable values

When variable is not defined, you can specify its default value:

$the( 'var_name', 'Default val' );
$var_name = $get( 'var_name', 'Default val' );

Available template methods

Template class methods.

Template constructor params

$template = new Awesome9\Templates\Template(
	$storage_name = 'frontend',
	$template_name = 'profile',
	$variables  = [
		'var_key' => $var_value,
	]
);

Helper functions

You can use the procedural approach as well:

// Print the template.
Awesome9\Templates\template( $storage_name, $template_name, $variables );

// Get the template output.
Awesome9\Templates\get_template( $storage_name, $template_name, $variables );

All the parameters remains the same as for the Template class.

📖 Changelog

See the changelog file