add more docs - drops, filters and endpoints

Author: GarPit

kms-drops.md

@@ -0,0 +1,50 @@
+## index
+Variable `index` accessible in templates and references to root page (with "index" slug). Object properties are the same as for `page` variable.
+
+```handlebars
+{% for p in: index.children do: %}
+  ...
+{% end for %}
+```
+
+## page
+Variable `page` can be accessed in any template and references to current page:
+
+```handlebars
+{{ page.title }}
+```
+
+Property of page	| Description
+        ---           |    ---
+slug | Value of "Slug" field
+fullpath | Page fullpath
+title | Value of "Title" field
+published | Value of "Published" field
+hidden | Value of "Hidden (from navigation)" field
+templatable | Value of "Use as object template" field
+children | Returns "children" collection - pages having this page as parent in "Parent page" field
+parent | Parent page reference
+
+## request
+Variable `request` gives an access to some properties of current request:
+
+```handlebars
+{{ request.form_authenticity_token }}
+```
+
+Property of request	| Description
+        ---           |    ---
+path | Returns request relative path
+url | Returns request URL
+host | Returns host - domain name or IP address
+base_url | Returns request root URL - protocol + domain name or IP, ex., "http://example.com"
+referer | Returns URL of page that initiated current request
+form_authenticity_token | Returns authenticity token for current request - for form protection from CSRF attack
+param() | Returns URL param. Example: request.param('page')
+
+## item
+Variable `item` gives access to current object of "templatable" page. "Templatable" - page with enabled "Use as object template" field and chosen object in "Object" field. Properties of `item` depend on concrete object. Please check out [KMS Models](/kms-models)
+
+```handlebars
+{{ item.title }}
+```

kms-filters.md

@@ -0,0 +1,44 @@
+## asset_path
+Filter `asset_path` allows to get a relative path to any file from "Assets" section by filename:
+
+```handlebars
+<img src="{{ 'logo.png' | asset_path }}">
+```
+
+## asset_tag
+Filter `asset_tag` allows to include javascript and css files, uploaded to "Assets" section:
+
+```handlebars
+{{ 'bootstrap.min.css' | asset_tag }}
+```
+
+## resize
+This function/filter helps to change image size on-the-fly. For this filter you need to use absolute URL of image and "format" argument. Returns also URL. To get absolute URL (having only relative - any asset from "Assets") you should use `request.base_url`:
+
+```handlebars
+{{ 'http://example.com/image.png' | resize format: '100x100' }}
+{{ (request.base_url + item.image) | resize format: '100x100' }}
+```
+
+## add_watermark
+It allows to add watermark to image. You need image URL and 3 arguments: "image" - watermark image (watermark), "dissolve" - transparency and "position" - position. Returns also URL:
+
+```handlebars
+{{ 'http://example.com/image.png' | add_watermark image: 'http://example.com/watermark.png' dissolve: '50%' position: 'center' }}
+```
+
+## ends_with
+Allows to check if string ends with some pattern:
+
+```handlebars
+{% if ends_with(media_item.file pattern: 'mp4') then: %}
+```
+
+## currency
+Formats currency values. Possible options: precision, delimiter, separator, format, unit:
+
+```handlebars
+# item.price is 100.0
+{{ item.price | currency precision: 0 }}
+# result - "100 руб."
+```

kms-models-drops.md

@@ -0,0 +1,6 @@
+## models
+Variable `models` gives access to models collections of entries. You can access collection using model collection name - "Collection name (for Liquor)" field. For example, if you created some Model with "services" collection name, then you could iterate its collection using "for" tag like this:
+
+```handlebars
+{% for service in: models.services do: %}
+```

kms-models-endpoints.md

@@ -0,0 +1,10 @@
+## POST /entries/:collection_name
+This endpoint allows you to setup form submitting Model's elements. For example, if you have a model with collection name "posts" (and field with "title" Liquor name), you could create a form with action="/entries/posts" and an input with name="entry[title]"
+
+```html
+<form action="/entries/:collection_name" method="post">
+  <input type="hidden" name='authenticity_token' value='{{ request.form_authenticity_token }}'>
+  <input type="text" name="entry[name]">
+  <input type="submit" value="Send">
+</form>
+```

sidebar.md

@@ -4,5 +4,11 @@
 - Liquor
  - [Tags](/tags)
  - [Variables](/variables)
+- KMS
+ - [Drops](/kms-drops)
+ - [Filters](/kms-filters)
+- KMS Models
+ - [Drops](/kms-models-drops)
+ - [Endpoints](/kms-models-endpoints)
 - Extensions
  - [Creating extension](/new-extension)