 |
jeremed
User
Nov 5, 2006, 6:12 AM
Post #1 of 11
(1279 views)
Shortcut
|
|
Is there a secret extra documentation somewhere?
|
Can't Post
|
|
I see many things in the default template set that aren't in the documentation.
There's no list of possible parameters for the template cells. There are a lot of other pieces which I don't see documented either:
pageDefault.embeddedMedia, article.externalLink, article.attachments.row, and more.
I used the templateplaceholderlist command to show a list of available parameters but there were a lot not included in that list.
(This post was edited by jeremed on Nov 5, 2006, 6:12 AM)
|
|
| |
|
ChetW
Staff
Nov 5, 2006, 11:18 AM
Post #2 of 11
(1265 views)
Shortcut
|
|
Re: [jeremed] Is there a secret extra documentation somewhere?
[In reply to]
|
Can't Post
|
|
Hi,
Thanks for the post!
We are doing our best to update the Article Manager2 documentation, the documents themselves are growing pices that we are constantly updating. I have made note of your request for some more indepth default template documentation, we are also happy to help you with any questions that you may have jeremed. :)
So if you have any questions about how certain areas of the software works or what specific placeholders do please feel free to ask!
Cheers,
Chet Woodside - Product Specialist
support@interactivetools.com
Hire me!
Save time by getting our experts to help with your project. Template changes, advanced features, full integration, whatever you need. Whether you need one hour or fifty, get it done fast with Priority Consulting.
|
|
| |
|
Theo
Project Manager
/ Moderator
Nov 5, 2006, 2:49 PM
Post #3 of 11
(1253 views)
Shortcut
|
|
Re: [jeremed] Is there a secret extra documentation somewhere?
[In reply to]
|
Can't Post
|
|
Jeremed,
I'd just like to add that a couple of the elements that you mentioned are related to uploaded files, which are documented in the Templates, specifically in the File/Image Uploads section:
http://www.interactivetools.com/docs/articlemanager2/templates/uploads.html
article.externalLink is just a regular article text field, but the upgrade routine adds a templateIf to make the link that similar to how it appears in Article Manager 1.
An important note about the templatePlaceholderList command: when you put it in an articleList template, you won't get any article placeholders listed unless you drop that command into the article row templateCell. TemplateCells are sort of like "mini templates", they have their own elements and placeholders.
Theo Wiersma
Project Manager
|
|
| |
|
jeremed
User
Nov 9, 2006, 8:07 PM
Post #4 of 11
(1208 views)
Shortcut
|
|
Re: [Theo] Is there a secret extra documentation somewhere?
[In reply to]
|
Can't Post
|
|
I've spent some more time with the documentation so I can figure some things out.
Here are a few of my questions that are still lingering:
1. On this page: http://www.interactivetools.com/docs/articlemanager2/templates/template_cell.html , how is $foo$ linked to the templateCell? I don't understand how it knows to replace that placeholder with the templateCell content.
1a. Similar question for this page: http://www.interactivetools.com/docs/articlemanager2/templates/template_insert.html How is the templateInsert linked to the templateCell? I don't understand what it's function there is.
2. For the templateCell tag, what other parameters are available other than "row"?
3. In the code, I see this tag: $article.externalLink$ On my outputted pages, it was showing up but with a broken url. I don't want to use this. I don't see a field on the article creation page to add a url. Where is the field this is referencing and how do I control it?
4. How do I make a summary page article like I used to with artman 1? There's no summary selection box anymore on the article creation screen.
|
|
| |
|
Theo
Project Manager
/ Moderator
Nov 10, 2006, 2:11 PM
Post #5 of 11
(1188 views)
Shortcut
|
Thanks for posting, jeremed! Hopefully I can help make things a bit clearer about what templateCells are and what they're for.
how is $foo$ linked to the templateCell? I don't understand how it knows to replace that placeholder with the templateCell content. (Just to be clear, $foo$ isn't actually anything, it's a meaningless placeholder used as an example. That may be obvious, but some people [Damon] thought that $foo$ was an actual placeholder from the program.)
$foo$ is connected to the templateCell only because the program knows it, it's hardcoded into the program logic. You don't need to do anything to tell the program to use a templateCell - in fact, you can't: the program either uses it, or it doesn't.
As mentioned in the docs, the rules and use for templateCells are defined by the program. The only templateCells you have in Article Manager 2 are for: (a) your articleLists; (b) your categoryLists; and (c) any upload fields that you have. You can't make up new ones (that's what templateIf is for).
- Your articleList templates MUST have an articleRow templatecell. This is generated where you put your $articleList$ placeholder.
- Your categoryList templates MUST have a categoryRow templateCell. This is generated where you put your $categoryList$ placeholder.
- Your common/embeddedMedia template MUST have a globalDefault.embeddedMedia templateCell. This is used for any of your embedded media uploads (e.g. ***image1***). Optionally, you can also override this default format for an individual template, if necessary (see the Embedded Media section of the File and Image Uploads template docs). If you've upgraded from 1.41, most of your templates will have an templateCell that reflects your design from your version 1 templates, but it's optional and you may just want to remove them.
- Any other upload field ("Single Upload" or "List of Attached Filed") needs a templateCell called $PLACEHOLDERNAME.row$. This is generated where you put your $PLACEHOLDER$.
For example, by default Article Manager has an $article.attachments$ field, for which the templates have a corresponding templateCell : article.attachments.row.
How is the templateInsert linked to the templateCell? I don't understand what it's function there is. TemplateInsert is totally unrelated to the templateCell. It's in a comment tag, so it's invisible when you view the raw template, but when you publish, just the placeholder remains. You can wrap anything in a templateInsert, the only value to it is that it will hide the content in a comment when viewing the template directly.
3. In the code, I see this tag: $article.externalLink$ On my outputted pages, it was showing up but with a broken url. I can't say for sure what the problem is without seeing your template, but I'm guessing you need to replace this:$article.externalLink$ With this:<!-- templateIf : $article.externalLink$ ne "" -->
[ <a href="$article.externalLink$">Visit Website</a> ]
<!-- /templateIf -->
4. How do I make a summary page article like I used to with artman 1? This is explained in detail here:
http://www.interactivetools.com/forum/gforum.cgi?post=50012#50012
I hope this all makes sense! I suspect some of what you're hoping to do with templateCells are actually done with templateIf. Or if you gave us some specifics, there might even be a better way altogether.
If you need any further assistance, just let me know. 
Theo Wiersma
Project Manager
|
|
| |
|
jeremed
User
Nov 12, 2006, 8:01 AM
Post #6 of 11
(1150 views)
Shortcut
|
Thank you for the information Theo.
What is $article.externalLink$ actually doing? Obviously it's creating external links, but to where and from what data?
|
|
| |
|
hsteensland
User
Nov 12, 2006, 9:15 AM
Post #7 of 11
(1144 views)
Shortcut
|
Is it possible to have the same templateCell twice in the same template if there is "opposite" templateIf's around them? For example, is it possible to have this code in the same category index template:
<!-- templateIf : $category.FIELDNAME$ == "0" -->
<!-- templatecell : articleRow -->
ARTICLE ROW CODE
<!-- /templatecell : articleRow -->
<!-- /templateIf -->
<!-- templateIf : $category.FIELDNAME$ == "1" -->
<!-- templatecell : articleRow -->
ARTICLE ROW CODE
<!-- /templatecell : articleRow -->
<!-- /templateIf --> |
|
| |
|
ross
Staff
/ Moderator
Nov 12, 2006, 5:01 PM
Post #8 of 11
(1116 views)
Shortcut
|
Hi there.
Thanks for getting back in touch .
The article.externalLink part is a placeholder refering to the externalLink field in your article table. The data that comes from that on your template is whatever you had entered in that field for the article you are currently looking at.
Does that make sense? Had you already created an externalLink field? I can show you how if you need to .s
-----------------------------------------------------------
Cheers,
Ross Fairbairn - Product Specialist
support@interactivetools.com
Hire me!
Save time by getting our experts to help with your project. Template changes, advanced features, full integration, whatever you need. Whether you need one hour or fifty, get it done fast with Priority Consulting.
|
|
| |
|
ross
Staff
/ Moderator
Nov 12, 2006, 5:06 PM
Post #9 of 11
(1114 views)
Shortcut
|
|
Re: [hsteensland] templateCells
[In reply to]
|
Can't Post
|
|
Hi there.
Thanks for posting!
I did a little testing and it looks like you'sll get to use the articleRow template cell once per template.
That’s ok though as you can just move the templateIfs inside the template cell like this:
<!-- templatecell : articleRow -->
<!-- templateIf : $category.FIELDNAME$ == "0" -->
ARTICLE ROW CODE
<!-- /templateIf -->
<!-- templateIf : $category.FIELDNAME$ == "1" -->
ARTICLE ROW CODE
<!-- /templateIf -->
<!-- /templatecell : articleRow -->
Of course, if you wanted to post up a few more details about what you were aiming for here, I can flesh out my example some more for you .
-----------------------------------------------------------
Cheers,
Ross Fairbairn - Product Specialist
support@interactivetools.com
Hire me!
Save time by getting our experts to help with your project. Template changes, advanced features, full integration, whatever you need. Whether you need one hour or fifty, get it done fast with Priority Consulting.
(This post was edited by ross on Nov 12, 2006, 5:07 PM)
|
|
| |
|
jeremed
User
Nov 13, 2006, 5:15 PM
Post #10 of 11
(1080 views)
Shortcut
|
Thanks. I was confused as I don't have that field in my first Artman 2 installation but I do in my second. I thought I saw it somewhere but I could not figure out where.
|
|
| |
|
