Added toPlaceholder property to getTags snippet

* origin/pr/12:
  toPlaceholder Support

Author: theboxer

Diff for: _build/data/transport.snippets.php

@@ -81,6 +81,14 @@
         'value' => '',
         'lexicon' => 'tagger:properties',
     ),
+    array(
+        'name' => 'toPlaceholder',
+        'desc' => 'tagger.gettags.toPlaceholder_desc',
+        'type' => 'textfield',
+        'options' => '',
+        'value' => '',
+        'lexicon' => 'tagger:properties',
+    ),
 
 );
 $snippets[0]->setProperties($properties);

Diff for: core/components/tagger/docs/changelog.txt

@@ -2,6 +2,7 @@ Changelog for Tagger.
 
 Tagger 1.1.0
 ==============
+- Added toPlaceholder property to getTags snippet
 - Duplicate Tags also for children
 - Improved gateway
 - Added handler for onResourceDuplicate event, that copies Tags (only for the Resource, not for children)

Diff for: core/components/tagger/elements/snippets/taggergettags.snippet.php

@@ -8,14 +8,15 @@
  *
  * PROPERTIES:
  *
- * &resources   string  optional    Comma separated list of resources for which will be listed Tags
- * &groups      string  optional    Comma separated list of Tagger Groups for which will be listed Tags
- * &rowTpl      string  optional    Name of a chunk that will be used for each Tag. If no chunk is given, array with available placeholders will be rendered
- * &outTpl      string  optional    Name of a chunk that will be used for wrapping all tags. If no chunk is given, tags will be rendered without a wrapper
- * &separator   string  optional    String separator, that will be used for separating Tags
- * &target      int     optional    An ID of a resource that will be used for generating URI for a Tag. If no ID is given, current Resource ID will be used
- * &showUnused  int     optional    If 1 is set, Tags that are not assigned to any Resource will be included to the output as well
- * &contexts    string  optional    If set, will display only tags for resources in given contexts. Contexts can be separated by a comma
+ * &resources       string  optional    Comma separated list of resources for which will be listed Tags
+ * &groups          string  optional    Comma separated list of Tagger Groups for which will be listed Tags
+ * &rowTpl          string  optional    Name of a chunk that will be used for each Tag. If no chunk is given, array with available placeholders will be rendered
+ * &outTpl          string  optional    Name of a chunk that will be used for wrapping all tags. If no chunk is given, tags will be rendered without a wrapper
+ * &separator       string  optional    String separator, that will be used for separating Tags
+ * &target          int     optional    An ID of a resource that will be used for generating URI for a Tag. If no ID is given, current Resource ID will be used
+ * &showUnused      int     optional    If 1 is set, Tags that are not assigned to any Resource will be included to the output as well
+ * &contexts        string  optional    If set, will display only tags for resources in given contexts. Contexts can be separated by a comma
+ * &toPlaceholder   string  optional    If set, output will return in placeholder with given name
  *
  * USAGE:
  *
@@ -41,6 +42,7 @@
 $resources = $tagger->explodeAndClean($resources);
 $groups = $tagger->explodeAndClean($groups);
 $contexts = $tagger->explodeAndClean($contexts);
+$toPlaceholder = $modx->getOption('toPlaceholder', $scriptProperties, '');
 
 $c = $modx->newQuery('TaggerTag');
 
@@ -109,4 +111,9 @@
     $out = $modx->getChunk($outTpl, array('tags' => $out));
 }
 
-return $out;
+if (!empty($toPlaceholder)) {
+    $modx->setPlaceholder($toPlaceholder, $out);
+    return '';
+}
+
+return $out;

Diff for: core/components/tagger/lexicon/en/properties.inc.php

@@ -17,4 +17,5 @@
 $_lang['tagger.gettags.separator_desc'] = 'String separator, that will be used for separating Tags';
 $_lang['tagger.gettags.target_desc'] = 'An ID of a resource that will be used for generating URI for a Tag. If no ID is given, current Resource ID will be used';
 $_lang['tagger.gettags.showUnused_desc'] = 'If 1 is set, Tags that are not assigned to any Resource will be included to the output as well';
-$_lang['tagger.gettags.contexts_desc'] = 'If set, will display only tags for resources in given contexts. Contexts can be separated by a comma';
+$_lang['tagger.gettags.contexts_desc'] = 'If set, will display only tags for resources in given contexts. Contexts can be separated by a comma';
+$_lang['tagger.gettags.toPlaceholder_desc'] = 'If set, output will return in placeholder with given name';