summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDaniel Weipert <code@drogueronin.de>2020-10-26 18:24:38 +0100
committerDaniel Weipert <code@drogueronin.de>2020-10-26 18:24:38 +0100
commit45ace6bc77793ea9da94fff6091711b2c94a5672 (patch)
tree895db637496f9237fc137a69ce613390504096ed
parent07f3b464dddf9f9298a44926f15c17f91447455d (diff)
Adds readme.txt for wordpress.org
-rw-r--r--readme.txt46
1 files changed, 46 insertions, 0 deletions
diff --git a/readme.txt b/readme.txt
new file mode 100644
index 0000000..9516774
--- /dev/null
+++ b/readme.txt
@@ -0,0 +1,46 @@
+=== Timber Editor ===
+Contributors: drogueronin
+Tags: timber, templates, twig
+Requires at least: 5.5
+Tested up to: 5.5.1
+Stable tag: 1.0.0
+Requires PHP: 7.4
+License: GPLv2 or later
+License URI: https://www.gnu.org/licenses/gpl-2.0.html
+
+Page, Theme & Plugin Editor Extension for Timber http://www.upstatement.com/timber/
+
+== Description ==
+
+### Features
+
+- adds a metabox to configurable Post-Types to create and edit Twig templates
+- adds Twig support to the WP Theme & Plugin editors
+ - you can even customize the CodeMirror theme
+
+### Plugin Dependencies
+
+- https://wordpress.org/plugins/timber-library/
+- https://wordpress.org/plugins/classic-editor/
+
+### How to use the MetaBox Feature
+
+The plugin uses the path defined in `Timber::$locations` as the templates path or falls back to the uploads folder if none is provided.
+
+Either adjust your `Timber::render('page.twig', $context)`-functions like this:
+```
+$filenames = [TimberEditor::getTemplateFilename(), 'page.twig'];
+Timber::render($filenames, $context);
+```
+
+like this
+```
+TimberEditor::render('page.twig', $context);
+# 'page.twig' serves as a fallback if the current posts's template doesn't exist
+```
+
+or like this
+```
+TimberEditor::renderPost('page.twig', $context);
+# renderPost() automatically adds ['post' => new Timber\Post()] to the $context
+```