Plates Versions Save

What's Changed

• Themes Support #234 by @ragboyjr in https://github.com/thephpleague/plates/pull/270
• Change callback PhpDoc type to callable by @vixducis in https://github.com/thephpleague/plates/pull/285
• Escape can take a null parameter php8.1 by @visavi in https://github.com/thephpleague/plates/pull/297
• Implement documented data assignment argument for Engine->make() by @Rayne in https://github.com/thephpleague/plates/pull/302
• Adding Community Extension by @basteyy in https://github.com/thephpleague/plates/pull/275

New Contributors

• @vixducis made their first contribution in https://github.com/thephpleague/plates/pull/285
• @visavi made their first contribution in https://github.com/thephpleague/plates/pull/297
• @Rayne made their first contribution in https://github.com/thephpleague/plates/pull/302
• @basteyy made their first contribution in https://github.com/thephpleague/plates/pull/275

Full Changelog: https://github.com/thephpleague/plates/compare/v3.4.0...v3.5.0

Added

• Added new unshift method in templates to support prepending content to sections (thanks @kozubsky)
• Added support for PHP8 (thanks @roxblnfk)

Changed

• Dropped explicit support for php 5. PHP 7/8 is allowed in composer, and only php 7.3-8.0 are tested in CI pipeline.

Internal Changes

• Minor modifications to repo workflow for CI with GitHub Actions instead of Travis
• Migrated docs from Jekyll to Hugo

EDIT (12/24/2020): This release has been abandoned. Some of this work will be merged into the v3 branch, but most of it has been scrapped. This tag will still be available, but a version 4 will not be based off of this alpha release.

v4 has been a complete rewrite in the plates system. It's fairly backwards compatible, but a lot of the internals have changed, and we still have a decent amount of features and work to do for v4.

Significant Changes

• Templates are Immutable VO's
• Rendering is handled via RenderTemplate interfaces
• Extensions are first class citizens
• The Engine is now a small wrapper for an IoC Container

New Features

• RenderContext API for defining composable functions and more
• Components
• Powerful and customizable naming strategies for dynamic base paths
• Multi folder fallbacks
• Relative and Absolute Path templates
• Better Error Handling
• Default Layouts
• Deep Sections #169
• Template Composers
• Static File Rendering
• Image/Base64Encoding Rendering
• And probably a few more ;p

Documentation is lacking for many of these features. Contributions are welcome! The best way to learn about the features it to look at the tests and examples.

• Added the ability to append content to sections using the new push() function.
• Added an end() function as an alias to stop().

• Fixed an issue where template functions were not accessible from extensions.
• Fixed an issued with the URI extension throwing errors when it shouldn't.
• Added the ability to get all template data by calling $template->data().
• Added the ability to render a template via the toString() magic method.
• Added the ability to run the tests using composer test.
• Improvements to error handling when rendering templates.
• Various coding style, CI and documentation improvements.

• Fix bug related to output buffering and exceptions (#78).
• Improvements to escaping (#56).
• Various CI and packaging improvements.

• Added batch functionality to the escaping functions.

• Added ability to define the default content of a section.
• Various code improvements (cleanup DocBlocks, class simplification, add Composer keywords, etc).

• Added all missing tests.
• Improved custom function name validation.
• Fixed bug with fallback folders, where the file extension wasn't being applied.
• Improved error handling in Template class.

• Updated extension interface to ensure that an instance of the Engine class be passed to the register() method.
• Minor code cleanup.