Carma list
From TMM Wiki
Jump to navigationJump to searchThe printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.
carma_list and carma_list_all
- Purpose: Retrieve actor, location, category or group data for one specific gallery or the whole database
- Usage: {carma_list list="actors,locations"}
- Required: list
- Optional: galid, var, count, start, siteid, section, active, order, alpha_letters
- Version: 1.3.0.1 or greater
- Default Templates Used: none
- Variables created: $carma_list, $params
Parameters
(Required parameters in bold)
Parameter | Description | Possible Values | Default Value | Example |
---|---|---|---|---|
list | Defines what type of data you want carma_list to return. | actors, locations, categories, groups, producers, orientation, type, quality, gender, race, hair, pubic, tits, dick, or body | None. | list="actors" |
galid | Only get the matching list for this gallery | Any valid gallery I.D. number | None. | galid="123" |
count | Maximum number of results to display (Click link for details) | Zero or any whole number greater than zero | 50 | count=20 |
start | Hide all results lower than this number (Click link for details) | Any whole number greater than zero | None. (Doesn't hide any results) | start=10 |
siteid | The site the items belong to | Any valid site I.D. number | None. | siteid="123" |
section | The section to get items from | A comma-delimited list of section I.D.s or a specific section I.Ds. | None. | section="123" |
active | Limit the search to active content (requires siteid and section variables to be set) | 1 | None. (Does not limit to active content.) | active="1" |
order | Which order to sort the gals in | active, caption, name | name | order="active" |
alpha_letters | Only grab the list starting with these letters | A comma-delimited list of letters | None. | alpha_letters="A,B,C" |
var | The Smarty variable to assign data too | Any valid Smarty variable | carma_list | var="my_variable" |
Description
This function retrieves a list of actors, locations, categories or groups. By default CARMA retrieves all actors, locations, categories, and groups stored in the CARMA database. If you only want to retrieve a list matching a specific gallery, define galid in the call to carma_list. The variables are stored in an array. For example, actors are stored as $carma_list.actor[], categories are stored as $carma_list.category[]. Each item in the array is again an array with each field being one of the fields in the corresponding database table.
Example
{carma_list siteid=$siteid count=500 order="name ASC" list="actors,locations,groups,categories" } <form method="get" action="index.php"> <input type="hidden" name="section" value="{$secid}"> Actor: <select size="5" name="actor"> {foreach from=$carma_list.actor item=actor} <option value="{$actor.actorid}">{$actor.name}</option> {/foreach} </select> <br> Category: <select size="5" name="category"> {foreach from=$carma_list.category item=category} <option value="{$category.catid}">{$category.name}</option> {/foreach} </select> <br> Group: <select size="5" name="group"> {foreach from=$carma_list.group item=group} <option value="{$group.gid}">{$group.name}</option> {/foreach} </select> <br> Location: <select size="5" name="location"> {foreach from=$carma_list.location item=location} <option value="{$location.locid}">{$location.name}</option> {/foreach} </select> <br> <input type="submit" name="searching" value="Search">