Jamroom: Developer Reference - Function jmSelect

Newsletter

Member Spotlight

Mediakinesis
"Media-Kinesis is an evolving multi-media community, designed to add value and strength to a music or video artists promotional strategies. Our musicians get high quality web sites featuring MP3 and WMV, and our listeners get the pleasure of streaming and downloading music and video legally! We've been providing multi-media on the web for over 8 years, and now with Jamroom we finally have the media/artist management technology that we've been missing!"

Function: jmSelect

jmRefresh

Function Index

jmShowLine

jmSelect

The jmSelect function is used for creating a <select> form element in a Jamroom Control Panel form.

form.tpl element name: form_select

return: Returns True/False on Success/Error

bool jmSelect (string $text, string $name, array $data, [string $selected = ''], [string $help = ''], [string $javascript = ''], [string $style = false], [array $_actions = false], [string $sub_title = false])

string $text: Title for form field - i.e. the string to the left in the Control Panel
string $name: Form field "name" value
array $data: Array containing key => value pairs for use as the <options> in the select form. This can also be a fully pathed filename containing key|value pairs, one per line.
string $selected: Option that will be selected on form load (i.e. existing or default value)
string $help: Help Text for the form field
string $javascript: Javascript that will be added into the <select> tag
string $style: Inline CSS style that will be added into the <select> tag
array $_actions: Additional form elements ("actions") that will appear below the input form field
string $sub_title: Sub Title that will appear under the title

Comments

SteveX, 02/11/09 10:40:31:

An example of building your select menu using information from he database:

// Get existing readings by this profile

$req = "SELECT read_id, read_name, read_created

FROM {$jamroom_db['ujStarsReadings']}

WHERE read_author_id = '{$_user['user_band_id']}'

ORDER BY read_created DESC";

$_rt = dbQuery($req,'NUMERIC');

if (isset($_rt[0]) && is_array($_rt[0])) {

foreach ($_rt as $_reading) {

$datex = date('d/m/Y',$_reading['read_created']);

$_sel["{$_reading['read_id']}"] = "{$_reading['read_id']}: {$_reading['read_name']} ({$datex})";

}

}

SteveX, 02/11/09 10:36:35:

If you are not using a text file you can build up your array in your php.

$_sel["Jupiter"] = "Venus discordant to Jupiter";
$_sel["Mars"] = "Venus discordant to Mars";
$_sel["Neptune"] = "Venus discordant to Neptune";
$_sel["Pluto"] = "Venus discordant to Pluto";
$_sel["Saturn"] = "Venus discordant to Saturn";
$_sel["_Uranus"] = "Venus discordant to Uranus";

jmSelect($language['ujStars'][11],'venus_discord',$_sel);

smith.kyle, 01/06/09 16:18:56:

You can pass a file containing your array of <option>'s as the $data param for jmSelect. The file needs to be set up as described here: http://www.jamroom.net/Jamroom4_jr_html_select, where each line contains the option value and text, separated by the | (pipe) symbol (or if no | is found, it will use the same text for both the option value and text). An example is:

jmSelect('Location','band_location',"{$jamroom['jm_dir']}/config/location.txt");

You must be logged in to post a comment

Solutions	Products	Support	Community	Company
Social Media Platform Social Networking Software Musician Website Manager Community Builder	Jamroom Core Jamroom Addons Jamroom Modules Jamroom Marketplace	Support Forum Documentation Support Center Contact Support	Community Forum Member Sites Developers	About Us Contact Us Privacy Policy
©2003 - 2012 Talldude Networks, LLC.