https://github.com/sjelfull/craft3-templateselect

A fieldtype that allows you to select a template from the site templates folder.
https://github.com/sjelfull/craft3-templateselect

craft-plugin craft3 craftcms craftcms-plugin fieldtype

Last synced: about 1 month ago
JSON representation

A fieldtype that allows you to select a template from the site templates folder.

• Host: GitHub
• URL: https://github.com/sjelfull/craft3-templateselect
• Owner: sjelfull
• License: mit
• Created: 2017-10-29T00:56:13.000Z (about 7 years ago)
• Default Branch: main
• Last Pushed: 2024-05-13T21:39:52.000Z (7 months ago)
• Last Synced: 2024-11-09T19:47:20.692Z (about 1 month ago)
• Topics: craft-plugin, craft3, craftcms, craftcms-plugin, fieldtype
• Language: PHP
• Homepage: https://superbig.co
• Size: 1.14 MB
• Stars: 17
• Watchers: 3
• Forks: 9
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE.md
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

        
# Template Select plugin for Craft CMS

A fieldtype that allows you to select a template from the site templates folder.

![Screenshot](resources/img/field-with-friendly.png)

## Requirements

This plugin requires Craft CMS 4.0 or later.

## Installation

To install the plugin, follow these instructions.

1. Open your terminal and go to your Craft project:

        cd /path/to/project

2. Then tell Composer to load the plugin:

        composer require superbig/craft3-templateselect

3. In the Control Panel, go to Settings → Plugins and click the “Install” button for Template Select.

## Configuring Template Select

Create a new field and choose field type Template Select.

In the field settings, you can limit the list of available templates to a subfolder of the Craft templates folder. The path is relative, i.e. _subfolder/anotherfolder_. This may also be set to an ENV variable.

![Screenshot](resources/img/field-settings.png)

![Screenshot](resources/img/field-without-friendly.png)

In the field settings, you can choose to make the template names more user friendly. In the field, the list will be improved by changing the following:

- file extensions will be removed

- the file names will be capitalized and spaced for readability

- folders will be separated by ›

![Screenshot](resources/img/field-with-friendly.png)

## Using Template Select

### Output the chosen template name:

```twig

{{ entry.fieldHandle }}

```

### Include/Embed the chosen template:

```twig

{% include entry.fieldHandle %}

```

### Include the template including subfolder if set:

```twig

{% include entry.fieldHandle.withSubfolder() %}

```

This is a alias for the following:

```twig

{{ entry.templateWithSubfolder.template(true) }}

```

### Output the subfolder name:

```twig

{{ entry.fieldHandle.subfolder() }}

```

### Output the filename without path:

```twig

{{ entry.fieldHandle.filename() }}

```

Brought to you by [Superbig](https://superbig.co)