|
Page 3 of 4
Now the display file - admin.jportfsimple.html.php - which displays the information provided by the "logic" file, earlier, or shows forms and input fields to enter new information. All backed functions are members of HTML_jportfsimple class: admin.jportfsimple.html.php // no direct access defined( '_VALID_MOS' ) or die( 'Direct Access to this location is not allowed.' ); class HTML_jportfsimple{
Configuration listing function is an example of using tabs, and also editor: admin.jportfsimple.html.php /** * Configuration listing */ function Conf_list( $option ) { ?> <script language="javascript" type="text/javascript"> function submitbutton(pressbutton) { <?php getEditorContents( 'editor', 'description' ); ?> submitform( pressbutton ); } </script> <script language="Javascript" src="js/dhtml.js"></script> <table class="adminheading"> <tr> <th><?php echo _COM_JP_CONFIG_INFO ?></th> </tr> </table> <table cellpadding="4" cellspacing="0" border="0" width="100%"> <tr> <td width="5%" class="tabpadding"> </td> <td id="tab1" class="offtab" onClick="dhtml.cycleTab(this.id)">Settings</td> <td id="tab2" class="offtab" onClick="dhtml.cycleTab(this.id)">CSS</td> <td width="5%" class="tabpadding"> </td> </tr> </table> <form action="index2.php" method="post" name="adminForm"> <div id="page1" class="pagetext"> <table cellpadding="4" cellspacing="0" border="0" width="90%" class="adminlist"> <tr> <th class= "title" width= "10%"><?php echo _COM_JP_CONFIG_PARAMETER ?></th> <th class= "title" width= "20%"><?php echo _COM_JP_CONFIG_VALUE ?></th> <th class= "title"><?php echo _COM_JP_CONFIG_DESCR ?></th> </tr> <tr> <td><?php echo _COM_JP_CONFIG_BASEPATH ?> </td> <td><input size="30" name="base_path" value="<?php echo $jpConf->base_path; ?>"> </td> <td><?php echo _COM_JP_CONFIG_BASEPATH_DESCR ?> </td> </tr> <tr> <td><?php echo _COM_JP_CONFIG_TITLE ?> </td> <td><input size="30" name="title" value="<?php echo $jpConf->title; ?>"> </td> <td><?php echo _COM_JP_CONFIG_TITLE_DESCR ?> </td> </tr> <tr> <td valign= "top" ><?php echo _COM_JP_CONFIG_FRONT_DESCR ?> </td> <td align="center" colspan="2"> <?php editorArea( 'editor', $jpConf->description , 'description', '600', '220', '60', '40' ) ; ?> </td> </tr> </table> </div> <div id="page2" class="pagetext"> <table cellpadding="4" cellspacing="0" border="0" width="90%" class="adminlist"> <tr> <th class= "title" width= "10%"><?php echo _COM_JP_CONFIG_PARAMETER ?></th> <th class= "title" width= "20%"><?php echo _COM_JP_CONFIG_VALUE ?></th> <th class= "title"><?php echo _COM_JP_CONFIG_DESCR ?></th> </tr> <tr> <td valign= "top" ><?php echo _COM_JP_CONFIG_CSS ?> </td> <td><input size="30" name="css_file" value="<?php echo $jpConf->css_file; ?>"> </td> <td valign= "top" ><?php echo _COM_JP_CONFIG_CSS_DESCR ?> </td> </tr> </table> </div> <input type="hidden" name="option" value="<?php echo $option; ?>" /> <input type="hidden" name="task" value="" /> <?php if ($jpConf->id) { ?> <input type= "hidden" name= "id" value= <?php echo $jpConf-> id ?> /> <?php } ?> <input type="hidden" name="act" value="configure" /> </form> <script language="javascript" type="text/javascript">dhtml.cycleTab('tab1');</script> <?php }
Lines 38 to 43 - are required for using WYSIWYG editor in a form (actually to get back the content of an editor). Editor is loaded in line 88. Notice the name of the editor field: 'editor' - if you'd like to use more than one editor, their names should be unique. 45 - this is needed for tabs. Their displayed names are defined in lines 56, 57, first open tab is defined in line 121, and then each tab content is displayed within a div. So here: tab1 - name: Settings, div id=page1 (line 63, 93) tab2 - name: CSS, div id=page2 (line 95, 111) As you see, each input field must have it's name, which must be the same as defined in class file, depending on object which is edited. The "hidden" fields (lines 113 to 118) are used to pass other variables, like $option or $act, so the backend "knows" where to go after you press "Save". Variable $task is empty initially - it's value is assigned when actual button in pressed. Variable $id is needed so the right record is saved. In case of configuration there is always only 1 record. Categories listing function: admin.jportfsimple.html.php /** * Category listing */ function Cat_list( $option, &$rows, &$pageNav ) { ?> <form action="index2.php" method="post" name="adminForm"> <table class="adminheading"> <tr> <th><?php echo _COM_JP_ALBUMS_INFO ?></th> </tr> </table> <table cellpadding="4" cellspacing="0" border="0" width="100%" class="adminlist"> <tr> <th width="20"><input type="checkbox" name="toggle" value="" onclick="checkAll(<?php echo count($rows); ?>);" /></th> <th class= "title" width= "20%"><?php echo _COM_JP_ALBUM_NAME ?></th> <th class= "title"><?php echo _COM_JP_ALBUM_PATH ?></th> <th class= "title"><?php echo _COM_JP_ALBUM_INFO ?></th> <th width= "5%"colspan= "2" align= "center"><?php echo _COM_JP_ORDER; ?></th> <th width="7%"></th> <th width= "7%"><?php echo _COM_JP_CONFIG_PUBLISHED; ?> </th> </tr> <?php if (count($rows)< 1) echo '<tr><td colspan="8" ><center><b>'._COM_JP_NO_CAT. '</b></center></td></tr>'; $k = 0; for ($i= 0, $n= count( $rows ); $i < $n; $i++ ) { $row = &$rows[$i]; ?> <tr class="<?php echo "row$k"; ?>"> <td><input type="checkbox" id="cb<?php echo $i;?>" name="cid[]" value="<?php echo $row->id; ?>" onclick="isChecked(this.checked);" /></td> <td><a href= "#edit" onclick= "hideMainMenu();return listItemTask('cb<?php echo $i;?>','edit')"><?php echo $row-> cat_name; ?></a></td> <td><?php echo $row-> cat_path; ?></td> <td><?php echo substr($row-> cat_info, 0, 30); ?></td> <td> <?php echo $pageNav-> orderUpIcon( $i, 1 ); ?> </td> <td> <?php echo $pageNav-> orderDownIcon( $i, $n, 1 ); ?> </td> <td> </td> <td align="center"> <?php if ($row->published == "1") { echo "<a href=\"javascript: void(0);\" onClick=\"return listItemTask('cb$i','unpublish')\"><img src=\"images/publish_g.png\" border=\"0\" /></a>"; } else { echo "<a href=\"javascript: void(0);\" onClick=\"return listItemTask('cb$i','publish')\"><img src=\"images/publish_x.png\" border=\"0\" /></a>"; } ?> </td> <?php $k = 1 - $k; ?> </tr> <?php } ?> </table> <?php echo $pageNav-> getListFooter(); ?> <input type="hidden" name="option" value="<?php echo $option; ?>" /> <input type="hidden" name="task" value="" /> <input type="hidden" name="boxchecked" value="0" /> <input type="hidden" name="hidemainmenu" value="0" /> <input type="hidden" name="act" value="categories" /> </form> <?php }
Here or in any similar listing function, few blocks are used: lines 141 to 150 - start of table, and column headers 153 - if no category defined yet, display warning
156 - loop through all categories
162 - checkbox for selecting categories
163 - displays category name with Javascript returning 'edit' value for $task variable
167, 170 - displays reordering icons
176 to 180 - displays 'published' or 'unpublished' icon
191 - displays select list - how many categories per page to display
Next function - category editing - is similar to configuration editing. Additionally it has Javascript doing basic field validation. It displays popup warning if category name or folder are not entered.
admin.jportfsimple.html.php <script language="javascript" type="text/javascript"> function submitbutton(pressbutton) { var form = document.adminForm; if (pressbutton == 'cancel') { submitform( pressbutton ); return; } // do fields validation if (form.cat_name.value == ''){ alert( "Category must have a name" ); } else if (form.cat_path.value == ''){ alert( "You must select a category folder" ); } else { <?php getEditorContents( 'editor', 'description' ); ?> submitform( pressbutton ); } } </script>
Project listing and project editing functions are similar to the above ones. Last function is 'Info' which displays information about the component. It shows logo, short description and version as defined in language file constants (_COM_JP_DESC, _COM_JP_VER1) and then it includes HTML file from help folder. admin.jportfsimple.html.php if (file_exists( $mosConfig_absolute_path. '/administrator/components/com_jportfsimple/help/'. $mosConfig_lang. '.html')) include_once( $mosConfig_absolute_path.'/administrator/components/com_jportfsimple/help/'. $mosConfig_lang.'.html'); else if (file_exists( $mosConfig_absolute_path. '/administrator/components/com_jportfsimple/help/english.html')) include_once( $mosConfig_absolute_path.'/administrator/components/com_jportfsimple/help/english.html');
If information in other language is not available, it will show english.html by default. It could be done differently - whole information could be also entered in one constant in language file, but I found it easier to update this way.
|