Update documentation

Author: mespeche

README.md

@@ -22,7 +22,92 @@ You can manage your keywords on the configuration view of the module with the "c
 
 To associate one or more keywords to a content or a folder, go to tab "Modules" of content or folder editing view.
 
-This module allow you to use 6 new loops : keyword_category, keyword_product, keyword_content, keyword_folder, keyword_group and keyword.
+This module allow you to use **6 new loops** : 
+*keyword_category*, *keyword_product*, *keyword_content*, *keyword_folder*, *keyword_group* and *keyword*.
+And **4 Smarty functions** : 
+*category_has_keyword*, *folder_has_keyword*, *product_has_keyword*, *content_has_keyword*
+
+## Loops
+
+#### keyword 
+**Input**
+| Argument | Value | Default value |
+|--------- | ----|----|
+|id|(int) keyword id||
+|visible|(int) 1 or 0|1|
+|keyword|(string) The keyword code||
+|folder|(int) ID or list of ID's of folder||
+|content|(int) ID or list of ID's of content||
+|category|(int) ID or list of ID's of category||
+|product|(int) ID or list of ID's of product||
+|order|(string) alpha, alpha-reverse, manual, manual_reverse, random, given_id|alpha|
+|keyword_group|(int) ID or list of ID's of keyword group||
+
+**Output**
+| Variable |
+|--------- |
+|$ID|
+|$KEYWORD_GROUP_ID|
+|$IS_TRANSLATED|
+|$LOCALE|
+|$TITLE|
+|$CODE|
+|$CHAPO|
+|$DESCRIPTION|
+|$POSTSCRIPTUM|
+|$POSITION|
+|$VISIBLE|
+|$CONTENTS_ASSOCIATION|
+|$FOLDERS_ASSOCIATION|
+|$CATEGORIES_ASSOCIATION|
+|$PRODUCTS_ASSOCIATION|
+|$HAS_PREVIOUS|
+|$HAS_NEXT|
+|$PREVIOUS|
+|$NEXT|
+
+#### keyword_group 
+**Input**
+| Argument | Value | Default value |
+|--------- | ----|----|
+|id|(int) keyword group id||
+|visible|(int) 1 or 0|1|
+|keyword|(string) The keyword group code||
+|order|(string) alpha, alpha-reverse, manual, manual_reverse, random, given_id|alpha|
+
+**Output**
+| Variable |
+|--------- |
+|$ID|
+|$IS_TRANSLATED|
+|$LOCALE|
+|$TITLE|
+|$CODE|
+|$CHAPO|
+|$DESCRIPTION|
+|$POSTSCRIPTUM|
+|$POSITION|
+|$VISIBLE|
+|$HAS_PREVIOUS|
+|$HAS_NEXT|
+|$PREVIOUS|
+|$NEXT|
+
+#### keyword_category, keyword_product, keyword_folder & keyword_content
+**Input**
+| Argument | Value | Default value |
+|--------- | ----|----|
+|keyword|(string) The keyword code||
+|association\_order|(string) manual, manual_reverse, random|manual|
+
+**Output**
+Same as default loops category, product, folder & content with :
+| Variable |
+|--------- |
+|$FOLDER_POSITION|
+|$CONTENT_POSITION|
+|$CATEGORY_POSITION|
+|$PRODUCT_POSITION|
 
 Here is an example of using each :