summaryrefslogtreecommitdiff
path: root/Readme.md
diff options
context:
space:
mode:
authorDaniel Weipert <code@drogueronin.de>2020-10-26 18:03:48 +0100
committerDaniel Weipert <code@drogueronin.de>2020-10-26 18:03:48 +0100
commit992a9d6ca186bb4399143dd5ee72a27a3b4909aa (patch)
treee9da01ac2ed233308b1477de5463ae80065afcd4 /Readme.md
Initial commitv1.0.0
Diffstat (limited to 'Readme.md')
-rw-r--r--Readme.md36
1 files changed, 36 insertions, 0 deletions
diff --git a/Readme.md b/Readme.md
new file mode 100644
index 0000000..fdd336a
--- /dev/null
+++ b/Readme.md
@@ -0,0 +1,36 @@
+## 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
+```
+
+## License
+
+(GPL v2)[LICENSE]