Difference between revisions of "Actor Documents"

From TMM Wiki
Jump to navigationJump to search
 
Line 5: Line 5:
 
''This article applies to CARMA 1.3.7.1 and greater''
 
''This article applies to CARMA 1.3.7.1 and greater''
  
−
Recent changes to CARMA now allow you to upload documents for an actor. These documents can be in any format and contain anything you wish. An example use of this feature would be uploading 2257 documents. There is also a new script in the member scripts directory called ''view_doc.php'' that will allow you to create links to documents on your site if you wish to allow members to view select files.  
+
[[CARMA]] contains the feature of allowing clients to upload documents for an actor. These documents can be in any format, and contain anything you wish.
 +
 
 +
For example, a use of this feature would be uploading 2257 documents for the actors featured on your sites. There is also a script in the member scripts directory called ''view_doc.php'' that will allow you to create links to documents on your site. This allows members to view select files.
  
 
== Managing Documents ==
 
== Managing Documents ==
−
Go to [[Actors Admin]] and select the Documents [[Image:Actors_document_icon.png||||||]] icon to the right of the actor you want to edit.
 
  
−
[[Image:Actors_document_manage.png|frame|center||||Figure 1.1 - Actors Admin - Managing actor documents]]
+
You can manage your documents by going to the [[CARMA Actors Admin|Actors Admin]] and selecting the "Add/Remove Documents" ([[Image:Actors_document_icon.png]]) icon to the right of the actor you wish to manage documents for.
  
−
On this page you will see two tables.  The first table, the ''Documents'' table, will list the current documents that CARMA has for this Actor. The second, the ''Add Document'' table is where you can add new documents.  
+
[[Image:Actors_document_manage.png|450px|Figure 1.1 - Actors Admin - Managing actor documents]]
 +
 
 +
On the "Manage Documents" page, there will be two available tables. The "Documents" table lists all current documents that [[CARMA]] has for that particular actor. Below, the "Add Document" table allows you to upload new documents, and choose if you want members to see your uploaded document.
 +
 
 +
The "Documents" table also contains three action icons. These icons allow you to view the selected document, download the document, or delete the document from [[CARMA]].
  
 
=== Add a New Document ===
 
=== Add a New Document ===
−
To add a new document fill in the form in the ''Add Document'' table.  You can optionally provide a name to use for display and reference purposes.  If you leave the name field blank it will default to the name of the file.  By default all documents are private and accessible only through the CARMA Admin.  If you wish for members to be able to have access to the file you are uploading then you should check the box next to ''Public''.
 
  
−
[[Image:Actors_document_upload.png|frame|center||||Figure 1.2 - Actors Admin - Uploading a new document]]
+
To add a new document to an actor, go back to the "Manage Documents" page in the [[CARMA Actors Admin|Actors Admin]]. In the "Add Document" table, you can optionally provide a name for your document, for display and reference purposes. If you leave the name field blank, the name will default to the document's file name.
 +
 
 +
All documents uploaded through [[CARMA]] are private, and can only be accessed through the [[CARMA]] Admins by default. To allow members to have access to the document you are uploading, check the box for the "Public" option. Once you have done this, click the "Choose File" button to upload a file from your hard drive. Click "Upload" when you are done to upload the selected document.
 +
 
 +
[[Image:Actors_document_upload.png|450px|Figure 1.2 - Actors Admin - Uploading a new document]]
  
 
=== Remove a Document ===
 
=== Remove a Document ===
−
To remove a document, click the trash can to the right of the document you wish to delete.
+
To remove a document that has been uploaded to [[CARMA]], simply go to the "Manage Documents" page via the [[CARMA Actors Admin|Actors Admin]] and click the Delete action icon.
  
−
[[Image:Actors_document_remove.png|frame|center||||Figure 1.3 - Actors Admin - Deleting a document]]
+
[[Image:Actors_document_remove.png|450px|Figure 1.3 - Actors Admin - Deleting a document]]
  
 
== Accessing a document ==
 
== Accessing a document ==
  
−
If you choose, you can allow public access to select documents.  You can do that on your member's templates with a link to the new script ''view_doc.php''. This script should be called like one of the two examples below:
+
If you have chosen to allow public access to certain documents, you can display them on your [[Members Area Templates]] by linking to the script ''view_doc.php''.  
  
 +
This script should be called like one of the two examples below:
  
 
=== View Document Example 1 ===
 
=== View Document Example 1 ===
Line 36: Line 45:
 
</pre>
 
</pre>
  
−
* [YOUR_SITE] is your url to your members site.
+
* [YOUR_SITE] is the URL to your Members site.
−
* <name> is the name of the document that your provided when uploading it  (such as my_story)
+
* <name> is the name of the document that you provided when uploading it  (such as my_story)
−
* <actorid> is the id of the actor that the document belongs to
+
* <actorid> is the ID of the actor that the document belongs to
  
 
Example:
 
Example:
Line 53: Line 62:
 
</pre>
 
</pre>
  
−
* [YOUR_SITE] is your url to your members site.
+
* [YOUR_SITE] is the URL to your Members site.
−
* <doc_id> is the id of the document.  See code below to get this id from the template functions
+
* <doc_id> is the ID of the document.  See code below to get this ID from the template functions
−
* <actorid> is the id of the actor that the document belongs to
+
* <actorid> is the ID of the actor that the document belongs to
  
 
Example:
 
Example:
Line 84: Line 93:
  
 
== Template Functions ==
 
== Template Functions ==
−
All template functions that deal with actor data have been modified to have an array called ''docs''. Modified templates are:
+
All template functions that deal with actor data have been modified to have an array called ''docs''. The modified templates are:
  
 
* [[carma_list_all]]
 
* [[carma_list_all]]

Latest revision as of 15:17, 19 August 2010

CARMA
Actors Admin
The Actors Admin
Add Actor
Actor Photos
Actor Documents
Manage Attribute Types
Creating Actor Pages

This article applies to CARMA 1.3.7.1 and greater

CARMA contains the feature of allowing clients to upload documents for an actor. These documents can be in any format, and contain anything you wish.

For example, a use of this feature would be uploading 2257 documents for the actors featured on your sites. There is also a script in the member scripts directory called view_doc.php that will allow you to create links to documents on your site. This allows members to view select files.

Managing Documents

You can manage your documents by going to the Actors Admin and selecting the "Add/Remove Documents" (Actors document icon.png) icon to the right of the actor you wish to manage documents for.

Figure 1.1 - Actors Admin - Managing actor documents

On the "Manage Documents" page, there will be two available tables. The "Documents" table lists all current documents that CARMA has for that particular actor. Below, the "Add Document" table allows you to upload new documents, and choose if you want members to see your uploaded document.

The "Documents" table also contains three action icons. These icons allow you to view the selected document, download the document, or delete the document from CARMA.

Add a New Document

To add a new document to an actor, go back to the "Manage Documents" page in the Actors Admin. In the "Add Document" table, you can optionally provide a name for your document, for display and reference purposes. If you leave the name field blank, the name will default to the document's file name.

All documents uploaded through CARMA are private, and can only be accessed through the CARMA Admins by default. To allow members to have access to the document you are uploading, check the box for the "Public" option. Once you have done this, click the "Choose File" button to upload a file from your hard drive. Click "Upload" when you are done to upload the selected document.

Figure 1.2 - Actors Admin - Uploading a new document

Remove a Document

To remove a document that has been uploaded to CARMA, simply go to the "Manage Documents" page via the Actors Admin and click the Delete action icon.

Figure 1.3 - Actors Admin - Deleting a document

Accessing a document

If you have chosen to allow public access to certain documents, you can display them on your Members Area Templates by linking to the script view_doc.php.

This script should be called like one of the two examples below:

View Document Example 1

Format: 

[YOUR_SITE]/view_doc.php?name=<name>&actorid=<actor_id>
  • [YOUR_SITE] is the URL to your Members site.
  • <name> is the name of the document that you provided when uploading it (such as my_story)
  • <actorid> is the ID of the actor that the document belongs to

Example: 

http://members.mysite.com/view_doc.php?name=my_story&actorid=3


View Document Example 2

Format: 

[YOUR_SITE]/view_doc.php?doc_id=<doc_id>&actorid=<actor_id>
  • [YOUR_SITE] is the URL to your Members site.
  • <doc_id> is the ID of the document. See code below to get this ID from the template functions
  • <actorid> is the ID of the actor that the document belongs to

Example: 

<h2>Actors</h2>
{carma_list count=500 list="actors" order="name ASC"}
{foreach from=$carma_list.actor item=actor}
  {if $actor.photo}
    <img src="view_image.php?actorid={$actor.actorid}&width=150&height=150"><br>
  {else}
    [no photo]<br>
  {/if}
  {$actor.name}<br>
  {if $actor.docs}
     Documents:<br>
    {foreach from=$actor.docs item=doc}
       - <a href="view_doc.php?doc_id={$doc.doc_id}&actorid={$actor.actorid}">{$doc.name}</a><br>
    {/foreach}
  {/if}
  <hr>
{/foreach}

The above example will list the actor, their photo, and a list of all their public documents.

Figure 2.1 - Members Site - Sample Output of smarty code to show documents


Template Functions

All template functions that deal with actor data have been modified to have an array called docs. The modified templates are:

Retrieved from "https://tmmwiki.com/index.php?title=Actor_Documents&oldid=10313"