Guys,
Can you explain the use of GetResources in plain English?
Can you make it clear/easy to understand?
Break it down to the simple basics.
Dumb it down for me, will you?
Step 1. I downloaded/installed Modx Revolution, and it’s working!
Step 2. Created 3 templates plus 3 resources, and all of them are working!
Step 3. Downloaded a snippet called "GetResources".
Step 4: However, it’s sitting in my "/snippets/" folder, not doing anything. I’d like to use it for outputting a list of my "resources" on one of my pages/resources. Is it too much to ask for? Or do I need to be more specific?
Now...
a) Now, what the heck should I do with the "GetResources" file?
MY IDEA 1: Leave *GetResources* file sitting in the ***snippets*** folder (or move it to somewhere else? )??????
In the documentation there are no instructions about this!
MY IDEA 2: Call it on one of my ***templates*** (or somewhere else)??????
In the documentation there are no instructions about this!
MY IDEA 3: Use the code ***[[getResources]]*** -- (or another variation of this code)?????
There are an unlimited number of possibilities, which only add to the confusion and lack of clear directions.
b) Don’t get me started on it. However, the so called GetResources "documentation" is hard to find. Then when
you do find it, you might find it’s ZERO help (at
http://rtfm.modx.com/display/ADDON/getResources). It’s so
little or no help that it’s incredible. It’s almost like as if the author was thinking, "OK, guys, I’m going
to write you a "document" but I will make it as brief/cryptic as possible, so that no one will understand it,
unless the reader/user/end user already knows more about it than I, myself, the author."
c) Ditto for the "examples". The examples are ZERO help (at
http://rtfm.modx.com/display/ADDON/getResources).
For example, quoting the document....
Example (from the documentation)
***********************************************************************************
Output a list of child Resources of the current Resource, using the ’myRowTpl’ chunk:
1 [[!getResources? &parents=`[[*id]]` &tpl=`myRowTpl`]]"
************************************************************************************
Okay, let’s try to follow this geeky/cryptic/hard-to-decypher instruction.
I tell you... no use so far.
My copy of GetResources is still in my snippets folder.
I’ve added the following code to "Template123", i.e. one of my templates:
Code
*****************************************************
[[!getResources? &parents=`[[*id]]` &tpl=`myRowTpl`]]
*********************************************************
I refresh the Resource123 page (i.e. the page that uses Template123).
What’s happened?
What’s the outcome of this exercise?
Do I see anything?
Do you see anything?
I see nothing!
Absolutely nothing!
Dumb it down for me, please!
Tell me about GetResources in plain English!
Explain it in baby talk!
Please!