/**
* Will render a specified form, the name of the form given by the first parameter;
*
* This method will render one of the forms for our object, invoked by giving the proper form identifier to the current form.
* We have chosen this method of invoking forms, because we just had too many this->renderSomethingMethod (), which really had
* an impact on code massiveness. Also, having code organized in switch/case statements leads us to be able to share common
* settings between different forms, as we've done with the methods defined in the __CALL method above;
*
* For example, if we wanted to share some common configuration between a create and an edit form, we could have introduced
* two switches in this method, one that would have set the common options, and the second, would have just passed through
* again, and get the already set configuration options, using them. This means that if we needed to change behavior of
* some interconnected forms, that would mean modifying the needed code one place only, which is a big advantage over
* having separated methods for each form. Maybe if we extended this object, you guys could understand the functionality ...
*
* @param string $objFormToRender The name of the form to render;
* @return mixed Depends on the rendered form if it returns something or not;
*/
public function renderBackendPage(S $objPageToRender)
{
// Get a specific CSS file for this controller ...
TPL::manageCSS(new FilePath($this->getPathToSkinCSS()->toRelativePath() . $objPageToRender . CSS_EXTENSION), $objPageToRender);
// Do pagination ...
if (isset($_GET[ADMIN_PAGINATION])) {
$objLowerLimit = (int) $_GET[ADMIN_PAGINATION]->toString() * 10 - 10;
$objUpperLimit = 10;
} else {
$objLowerLimit = 0;
$objUpperLimit = 10;
}
// Do a switch on the rendered page ...
switch ($objPageToRender) {
case 'welcomePage':
// Set the template file ...
$tpF = new FilePath($this->getPathToSkin()->toRelativePath() . 'welcomePage.tp');
TPL::tpSet(self::$objAdministration->getWidget(NULL), new S('objWidgets'), $tpF);
TPL::tpExe($tpF);
break;
case 'manageUsers':
// Do specific actions, based on _GET parameters;
if (isset($_GET[ADMIN_ACTION])) {
// Switch ...
switch ($_GET[ADMIN_ACTION]) {
case ADMIN_ACTION_EDIT:
$this->renderForm(new S('userEdit'));
break;
case ADMIN_ACTION_ERASE:
$this->renderForm(new S('userErase'));
break;
}
} else {
// Show them ordered by DESC;
if (!isset($_GET[ADMIN_ACTION_SORT])) {
$this->setHeaderKey(URL::rewriteURL(new A(array(ADMIN_ACTION_SORT)), new A(array('DescByRegistered'))), new S('Location'));
}
// Set some requirements;
$objGetCondition = new S();
if (isset($_GET[ADMIN_ACTION_BY])) {
// Do a switch ...
switch ($_GET[ADMIN_ACTION_BY]) {
case AUTHENTICATION_PROFILE_USERNAME:
$objGetCondition->appendString('WHERE %objAuthUsersTableFUName');
break;
case AUTHENTICATION_PROFILE_EMAIL:
$objGetCondition->appendString('WHERE %objAuthUsersTableFEML');
break;
case AUTHENTICATION_PROFILE_GROUP:
$objGetCondition->appendString('AS t1 LEFT JOIN %objAuthGroupTable
AS t2 ON t1.%objAuthUsersTableFUGId = t2.%objAuthGroupTableFId
WHERE t2.%objAuthGroupTableFName');
break;
}
// Add LIKE searching ...
$objGetCondition->appendString(_SP)->appendString('LIKE "%%Search%"')->doToken('%Search', $_GET[ADMIN_ACTION_SEARCH]);
}
if (isset($_GET[ADMIN_ACTION_SORT])) {
// Switch ...
switch ($_GET[ADMIN_ACTION_SORT]) {
case 'AscByUsername':
case 'DescByUsername':
// Set the order ...
$objGetCondition->appendString(_SP)->appendString('ORDER BY %objAuthUsersTableFUName');
// Switch ...
switch ($_GET[ADMIN_ACTION_SORT]) {
case 'AscByUsername':
$objGetCondition->appendString(_SP)->appendString('ASC');
break;
case 'DescByUsername':
$objGetCondition->appendString(_SP)->appendString('DESC');
break;
}
break;
case 'AscByEMail':
case 'DescByEMail':
// Set the order ...
$objGetCondition->appendString(_SP)->appendString('ORDER BY %objAuthUsersTableFEML');
// Switch ...
switch ($_GET[ADMIN_ACTION_SORT]) {
case 'AscByEMail':
$objGetCondition->appendString(_SP)->appendString('ASC');
break;
case 'DescByEMail':
$objGetCondition->appendString(_SP)->appendString('DESC');
break;
}
break;
case 'AscByGroup':
case 'DescByGroup':
// Set the order ...
if (isset($_GET[ADMIN_ACTION_BY])) {
$objGetCondition->appendString(_SP)->prependString('AS t1 LEFT JOIN %objAuthGroupTable
AS t2 ON t1.%objAuthUsersTableFUGId = t2.%objAuthGroupTableFId ');
} else {
$objGetCondition->appendString(_SP)->appendString('AS t1 LEFT JOIN %objAuthGroupTable
AS t2 ON t1.%objAuthUsersTableFUGId = t2.%objAuthGroupTableFId ');
}
// Add order by ...
$objGetCondition->appendString(_SP)->appendString('ORDER BY t2.%objAuthGroupTableFName');
// Switch ...
switch ($_GET[ADMIN_ACTION_SORT]) {
case 'AscByGroup':
$objGetCondition->appendString(_SP)->appendString('ASC');
break;
case 'DescByGroup':
$objGetCondition->appendString(_SP)->appendString('DESC');
break;
}
break;
case 'AscByRegistered':
case 'DescByRegistered':
// Set the order ...
$objGetCondition->appendString(_SP)->appendString('ORDER BY %objAuthUsersTableFRegOn');
// Switch ...
switch ($_GET[ADMIN_ACTION_SORT]) {
case 'AscByRegistered':
$objGetCondition->appendString(_SP)->appendString('ASC');
break;
case 'DescByRegistered':
$objGetCondition->appendString(_SP)->appendString('DESC');
break;
}
break;
}
}
// Make the unordered condition;
$objGetCondition = $objGetCondition->appendString(_SP)->appendString('LIMIT %LowerLimit, %UpperLimit')->doToken('%LowerLimit', $objLowerLimit)->doToken('%UpperLimit', $objUpperLimit);
// Get the users ...
$objUsersTable = $this->getUsers($objGetCondition);
if (isset($_GET[ADMIN_ACTION_BY])) {
$objUsersTableCount = $objUsersTable->doCount();
} else {
$objUsersTableCount = $this->getUserCount();
}
// Get each group for each user ...
foreach ($objUsersTable as $k => $v) {
$v['group_name'] = $this->getGroupInfoById($v[Authentication::$objAuthUsersTableFUGId], Authentication::$objAuthGroupTableFName);
}
// Fix pagination when count is LESS than 10;
if (isset($_GET[ADMIN_ACTION_BY]) && isset($_GET[ADMIN_PAGINATION])) {
if ($objUsersTableCount->toInt() < 10) {
// Remove paging ... & redirect to proper ...
TPL::setHeaderKey(URL::rewriteURL(new A(array(ADMIN_PAGINATION))), new S('Location'));
} else {
if (CEIL($objUsersTableCount->toInt() / 10) < (int) $_GET[ADMIN_PAGINATION]->toString()) {
// Redirect to proper ...
TPL::setHeaderKey(URL::rewriteURL(new A(array(ADMIN_PAGINATION)), new A(array(CEIL($objUsersTableCount->toInt() / 10)))), new S('Location'));
}
}
}
// Set the template file ...
$tpF = new FilePath($this->getPathToSkin()->toRelativePath() . 'manageUsers.tp');
TPL::tpSet($objUsersTable, new S('usersTable'), $tpF);
TPL::tpSet($this->STG, new S('STG'), $tpF);
TPL::tpExe($tpF);
// Do them pagination ...
if ($objUsersTableCount->toInt() > 10) {
self::$objAdministration->setPagination($objUsersTableCount);
}
// Set a search form;
$this->renderForm(new S('userSearch'));
$this->renderForm(new S('userCreate'));
}
break;
case 'manageGroups':
// Add some requirements;
TPL::manageJSS(new FilePath($this->getPathToSkinJSS()->toRelativePath() . 'manageGroups.js'), new S('manageCategories'));
// Do specific actions, based on _GET parameters;
if (isset($_GET[ADMIN_ACTION])) {
switch ($_GET[ADMIN_ACTION]) {
case ADMIN_ACTION_EDIT:
$this->renderForm(new S('groupEdit'));
break;
case ADMIN_ACTION_ERASE:
$this->renderForm(new S('groupErase'));
break;
case ADMIN_ACTION_MOVE:
$this->renderForm(new S('groupMove'));
break;
}
} else {
// Do an empty SQL string;
$objGetCondition = new S();
// Do a sorting, before anything else;
if (isset($_GET[ADMIN_ACTION_SORT])) {
switch ($_GET[ADMIN_ACTION_SORT]) {
case 'DescByGroup':
$objGetCondition->appendString(_SP)->appendString('DESC');
break;
case 'AscByGroup':
$objGetCondition->appendString(_SP)->appendString('ASC');
break;
}
}
// Add some LIMITs;
$objGetCondition->appendString(_SP)->appendString('LIMIT %LowerLimit, %UpperLimit')->doToken('%LowerLimit', $objLowerLimit)->doToken('%UpperLimit', $objUpperLimit);
// Set some requirements;
$objGroupTable = $this->getGroups(isset($_GET[ADMIN_SHOW_ALL]) ? new S() : $objGetCondition);
$objGroupTableCount = $this->getGroupCount();
// Set the template file ...
$tpF = new FilePath($this->getPathToSkin()->toRelativePath() . 'manageGroups.tp');
TPL::tpSet($objGroupTable, new S('groupTree'), $tpF);
TPL::tpExe($tpF);
// Do them paginations ...
if ($objGroupTableCount->toInt() > 10 && !isset($_GET[ADMIN_SHOW_ALL])) {
self::$objAdministration->setPagination($objGroupTableCount);
}
// Do the form, make it happen;
$this->renderForm(new S('groupCreate'));
}
break;
case 'manageZones':
// Do specific actions, based on _GET parameters;
if (isset($_GET[ADMIN_ACTION])) {
// Switch ...
switch ($_GET[ADMIN_ACTION]) {
case ADMIN_ACTION_EDIT:
$this->renderForm(new S('zoneEdit'));
break;
case ADMIN_ACTION_ERASE:
$this->renderForm(new S('zoneErase'));
break;
}
} else {
// Do a sorting beforehand;
$objGetCondition = new S();
if (isset($_GET[ADMIN_ACTION_SORT])) {
switch ($_GET[ADMIN_ACTION_SORT]) {
case 'AscByZone':
case 'DescByZone':
// Switch ...
switch ($_GET[ADMIN_ACTION_SORT]) {
case 'AscByZone':
$objGetCondition->appendString(_SP)->appendString(new S('ASC'));
break;
case 'DescByZone':
$objGetCondition->appendString(_SP)->appendString(new S('DESC'));
break;
}
break;
}
}
// Add some LIMITs
$objGetCondition->appendString(_SP)->appendString('LIMIT %LowerLimit, %UpperLimit')->doToken('%LowerLimit', $objLowerLimit)->doToken('%UpperLimit', $objUpperLimit);
// Set some requirements;
$objZonesTable = $this->getZones($objGetCondition);
$objZonesTableCount = $this->getZoneCount();
// Set the template file ...
$tpF = new FilePath($this->getPathToSkin()->toRelativePath() . 'manageZones.tp');
TPL::tpSet($objZonesTable, new S('zonesTable'), $tpF);
TPL::tpExe($tpF);
// Do them paginations ...
if ($objZonesTableCount->toInt() > 10) {
self::$objAdministration->setPagination($objZonesTableCount);
}
}
break;
case 'manageMappings':
// Do specific actions, based on _GET parameters;
if (isset($_GET[ADMIN_ACTION])) {
switch ($_GET[ADMIN_ACTION]) {
case ADMIN_ACTION_EDIT:
$this->renderForm(new S('zoneMappingEdit'));
break;
case ADMIN_ACTION_ERASE:
$this->renderForm(new S('zoneMappingErase'));
break;
}
} else {
// Do a sorting beforehand;
$objGetCondition = new S();
if (isset($_GET[ADMIN_ACTION_SORT])) {
// Switch ...
switch ($_GET[ADMIN_ACTION_SORT]) {
case 'AscByGroup':
case 'DescByGroup':
// Set some requirements;
$objGetCondition->appendString(_SP)->appendString('AS t1 LEFT JOIN %objAuthGroupTable
AS t2 ON t1.%objAuthZoneMTableFUGId = t2.%objAuthGroupTableFId
ORDER BY t2.%objAuthGroupTableFName');
switch ($_GET[ADMIN_ACTION_SORT]) {
case 'AscByGroup':
$objGetCondition->appendString(_SP)->appendString('ASC');
break;
case 'DescByGroup':
$objGetCondition->appendString(_SP)->appendString('DESC');
break;
}
break;
case 'AscByZoneForGroup':
case 'DescByZoneForGroup':
// Set some requirements;
$objGetCondition = new S('AS t1 LEFT JOIN %objAuthZonesTable
AS t2 ON t1.%objAuthZoneMTableFZId = t2.%objAuthGroupTableFId
ORDER BY t2.%objAuthZonesTableFName');
switch ($_GET[ADMIN_ACTION_SORT]) {
case 'AscByZoneForGroup':
$objGetCondition->appendString(_SP)->appendString('ASC');
break;
case 'DescByZoneForGroup':
$objGetCondition->appendString(_SP)->appendString('DESC');
break;
}
break;
}
}
// LIMIT only TO GROUP;
if ($objGetCondition->toLength()->toInt() != 0) {
$objGetCondition->doToken('ORDER', new S('WHERE %objAuthZoneMTableFIUG = "Y" ORDER'));
} else {
$objGetCondition = new S('WHERE %objAuthZoneMTableFIUG = "Y"');
}
// Add SOME LIMITs;
$objGetCondition->appendString(_SP)->appendString('LIMIT %LowerLimit, %UpperLimit')->doToken('%LowerLimit', $objLowerLimit)->doToken('%UpperLimit', $objUpperLimit);
// Set some requirements;
$objZoneMappings = $this->getZoneMappings($objGetCondition);
$objMappingsTableCount = $this->getMappingCount(new S('WHERE %objAuthZoneMTableFIUG = "Y"'));
// Set the template file ...
$tpF = new FilePath($this->getPathToSkin()->toRelativePath() . 'manageMappings.tp');
TPL::tpSet($objZoneMappings, new S('zonesMappingsTableForGroup'), $tpF);
TPL::tpExe($tpF);
// Do pagination;
if ($objMappingsTableCount->toInt() > 10) {
self::$objAdministration->setPagination($objMappingsTableCount);
}
// Do the form, make it happen;
$this->renderForm(new S('zoneMappingCreateForGroups'));
}
break;
case 'manageMappingsForUsers':
// Do specific actions, based on _GET parameters;
if (isset($_GET[ADMIN_ACTION])) {
switch ($_GET[ADMIN_ACTION]) {
case ADMIN_ACTION_EDIT:
$this->renderForm(new S('zoneMappingEdit'));
break;
case ADMIN_ACTION_ERASE:
$this->renderForm(new S('zoneMappingErase'));
break;
}
} else {
// Do a sorting beforehand;
$objGetUCondition = new S();
if (isset($_GET[ADMIN_ACTION_SORT])) {
switch ($_GET[ADMIN_ACTION_SORT]) {
case 'AscByZone':
case 'DescByZone':
// Set some requirements;
$objGetUCondition = new S('AS t1 LEFT JOIN %objAuthZonesTable
AS t2 ON t1.%objAuthZoneMTableFZId = t2.%objAuthUsersTableFId
ORDER BY t2.%objAuthZonesTableFName');
switch ($_GET[ADMIN_ACTION_SORT]) {
case 'AscByZone':
$objGetUCondition->appendString(_SP)->appendString('ASC');
break;
case 'DescByZone':
$objGetUCondition->appendString(_SP)->appendString('DESC');
break;
}
break;
case 'AscByUsername':
case 'DescByUsername':
// Set some requirements;
$objGetUCondition = new S('AS t1 LEFT JOIN %objAuthUsersTable
AS t2 ON t1.%objAuthZoneMTableFUGId = t2.%objAuthUsersTableFId
ORDER BY t2.%objAuthUsersTableFUName');
switch ($_GET[ADMIN_ACTION_SORT]) {
case 'AscByUsername':
$objGetUCondition->appendString(_SP)->appendString('ASC');
break;
case 'DescByUsername':
$objGetUCondition->appendString(_SP)->appendString('DESC');
break;
}
break;
}
}
// LIMIT ONLY to USERS;
if ($objGetUCondition->toLength()->toInt() != 0) {
$objGetUCondition->doToken('ORDER', new S('WHERE %objAuthZoneMTableFIUG = "N" ORDER'));
} else {
$objGetUCondition = new S('WHERE %objAuthZoneMTableFIUG = "N"');
}
// Set some requirements;
$objMappingsTableCount = $this->getMappingCount(new S('WHERE %objAuthZoneMTableFIUG = "N"'));
$objZoneMappings = $this->getZoneMappings($objGetUCondition);
// Set the template file;
$tpF = new FilePath($this->getPathToSkin()->toRelativePath() . 'manageMappingsForUsers.tp');
TPL::tpSet($objZoneMappings, new S('zonesMappingsTableForUsers'), $tpF);
TPL::tpExe($tpF);
// Do pagination;
if ($objMappingsTableCount->toInt() > 10) {
self::$objAdministration->setPagination($objMappingsTableCount);
}
// Do the form, make it happen;
$this->renderForm(new S('zoneMappingCreateForUsers'));
}
// Break out;
break;
case 'manageConfiguration':
if (isset($_GET[ADMIN_ACTION])) {
$this->renderForm($_GET[ADMIN_ACTION]);
} else {
$this->renderForm(new S('configurationEdit'));
}
break;
}
}
/**
* Will return an unique code, based on a combination of sha1 and uniqid. First of ALL: do not relly on this method to return
* the same hash code again and again, as for a combination of sha1 (2^64) it will never return the same code twice upon a large
* field of possible situations. This method is rarelly used but has been promoted as a CORE method to generate a hased unique code
* for different purposes (weak encryption, random things, etc.);
* <code>
* <?php
* // Get an unique code
* echo EXE::getUniqueCode (); # Will return a sha1 (uniqid ());
* ?>
* </code>
*
* @param I $objLength The length of the string to get
* @return S The code, stripped down to the desired length
* @author Catalin Z. Alexandru <*****@*****.**>
* @copyright Under the terms of the GNU General Public License v3
* @version $Id: 02_EXE.php 313 2009-10-09 13:27:52Z catalin.zamfir $
* @since Version 2.0
* @access public
* @static
* @final
*/
public static final function getUniqueCode(I $objLength = NULL)
{
// Get the code, from an md5, of uniqid;
$objCode = new S(sha1(uniqid(rand(), TRUE)));
// Either get it FULL, or just first N chars;
if ($objLength == NULL) {
// Return the code;
return $objCode;
} else {
// Check something ...
if ($objLength->toInt() > $objCode->toLength()->toInt()) {
// Return the code;
return $objCode;
} else {
// Trim it down to size ...
return $objCode->doSubStr(0, $objLength->toInt());
}
}
}
