Documentation Mailing Lists FAQ Frequently Asked Questions v2

How can I use the related items feature to link items from one slice into another Author: Mitra mitra@earth.path.net

Related Categories: Slice Administrator Related Items   Comments :209 Add Comment

** Input (setting the admin interface)

1. go to Admin - Fields
2. add new field to the slice, where you want to store related item
3. go to Edit page for the new field (Admin - Fields - Edit)
4. choose one of the following options in 'Input type' selectbox:
   - Related Item Window
   - Multiple SelectBox
   - Select box
   - Check box
   - Multiple Checkboxes
   - RadioButton
   (this is sorted in order of usability - most useful is 'Related Item Window' or Selectbox)
5. If you choose 'Related Item Window' then in the Constant field you can select not only the constants groups, but you can select there also the slice! If you select there the slice, there will be item headlines as options in the inputform. It allows you to select related items for the one you are writing. As you see it is possible to select any slice in here, so it is possible to create related items not only from the current slice, but to another slice too. It is possible to have the slice of items and another slice of authors and then set the relation through such field. For related item just select there the same slice you are in.
6. Select the 'Item IDs' option in Insert field to be the related items ids correctly written to database.
7. click on 'Update' - Input is set

One Note on 'Related Item Window' - in fact it is the only one option to use if you want to use the field as 'Related Item' because other options shows all slice items on one page, which is usually too much. Another feature of 'Related Item Window' is, that it is possible to add items not only to the written item, but you can add '2 way relation' between items - written item (say 2) is not only related to assigned item 1, but the item 1 is then related to item 2 then.

The next problem is, how to display the related items on webpage.

** Output (1) - Standard use of views

1. go to Admin - Design Views page
2. create new view (you can create the 'Fulltext view' if you want to show only one item or you can create 'Item listing' view for displaying more than one item in view)
3. Fill the name of view, Top, Bottom and Odd row HTML code (the condition fields you can leave blank)
   For example:
   Item listing: Item List - related test
   Odd Rows: <br>Related: How can I use the related items feature to link items from one slice into another
4. Click on 'Update'
5. Create page which includes the view. Say the view number is 110:
   related.shtml
   APC - ActionApps Test Site
6. go to Admin - Fields - Related field Edit page
7. create an alias for the Related field:
   Alias 1: _#RELATED_ (the name is up to you)
   Function: f_h
   Parameters: -
   (the parameter is DASH - used as separator for multiple item ids)
8. go to 'Admin - Design Index' page
9. Add next code to 'Odd rows' field:
   <a href="related.shtml?cmd[110]=i-110-_#RELATED_">Related</a>
10. click Update - link to related stories Done
    

This is the way, how to create link to related item view and also this is the way, how to create link to fulltext view

For related item however we expected another behavior. We want to display related items under the fulltext of the item (or directly under each item on index page). That's why we introduced 'view as alias feature':

** Output (2) - view as alias

steps 1) - 4) is exactly the same as in Output (1)

5. go to Admin - Fields - Related field Edit page
6. create an alias for the Related field:
   Alias 2: _#SHOWVIEW (the name is up to you)
   Function: f_v
   Parameters: vid=110&cmd[110]=i-110-_#this
   As the parameter we write the same parameters we would write for view.php3 as url parameters. The only difference is, that we use the keyword _#this, which is substituted by item ids from the field.
   Note: _#this is not alias - is is not defined as other aliases, it is much more the keyword - see Paramater substitution in f_v
7. go to 'Admin - Design Fulltext' page (for example)
8. Add next code to 'Fulltext HTML code' field:
   <br>Related: _#SHOWVIEW
9. click Update - related items displayed

Output (2) describes how to create view alias. With such alias you can work as with any other aliases.

Tip:
In step 6) of Output (2) we used field content as list of displayed items:

vid=110&cmd[110]=i-110-_#this

In some cases we may want to switch between the views depending on field content. Then you can use parameter like:

vid=110&cmd[110]=v-_#this

vid=110&cmd[110]=i-_#unspecified.....-_#this

Then the fields <this> in example a) or unspecified..... in example b) should contain the ids of view to show (112, 113...).

How do I create a View which indexes all items that relate to that item.

An example might help..

I have two slices 'authors' and 'articles'.

In articles I have a field 'author' which relates to the slice 'authors' (in it is stored ID or IDs of author/authors of the article).

So in articles on the web is displayed information from the 'authors' slice.

But now I would like to show references to articles on the pages of their authors. And I don't want to make it by a new relation field in the slice 'articles', because I would have to after addition of a new article go to the slice 'authors' and edit the author's profile - make a relation to the new article.

Do you have some idea, how to display the information from the slice 'articles' in the slice 'authors' if the relation field is in the slice 'articles'?

Yes, it should be possible to display author's articles, because there is the "relation" field for Author (the created_by.....1 in your case) in the Article slice. There are the ids of 'Author' records (items) stored in this field. So, it is possible to create view (say number 123) in 'Article' slice where the first condition will be

Author =

Then, you just create the page which includes the view:

---author.shtml ---
<!--#include virtual="/aaa/view.php3?vid=123"-->

The link to this page then should look like:

author.shtml?cmd[123]=c-1-5254422456eab4763bea34

where 5254422456eab4763bea34is item (=author) id in Author slice. Such link can be generated automaticaly Index - Odd row (for example):

<a href="author.shtml?cmd[123]=c-1-4f35cd6ab328690caffbe7d646eded78">_#NAME####</a>

Last Edit: Aug 17 2011

<aafaq id=1736> ~ToDo: 1736 How can I use the related items feature to link items from one slice into another </aafaq> 

This FAQ interface was developed by Jason at Commons.ca

APC ActionApps is a free software content management system initiated by the Association for Progressive Communications (APC) APC - Internet and ICTs for social justice and development