The template controller - get and set template settings. More...

Public Member Functions
	checkIfTemplateAlreadyExists (object $db, string $name)
	Check if a template with given name already exists, return true or false. More...

	deleteSettingsCSSFile ($db, $filename)

	downloadTemplate ($db, $templateFolder, $templateID, $user)
	Create a zip file from template and force direct download. More...

	drawFontFamilySelectField ($db, $lang, $selectName, $defaultValue)
	return a select option list with all fonts: More...

	emptyTmpFolder ()

	getCustomCSSFile (object $db, int $templateID)
	return the content of custom.css More...

	getCustomJSFile (object $db, int $templateID)
	return the content of custom.js More...

	getFontRow ($db, $lang, $fontRow, $previewClass, $templateSettings)
	return font edit row including preview More...

	getFormElements ($db, $settings, $type, $lang, $user)
	return html form field, depending on fieldClass More...

	loadActiveAssets ($db, $templateID, $host)
	Load Active Assets. More...

	loadActiveAssetsIntoArray ($db, $templateID)

	loadAllSettingsIntoArray (object $db, int $id)
	load template settings of ID and return as array More...

	loadProperties ($db, $id)
	load properties into template object More...

	loadPropertiesIntoArray (object $db, int $id)
	load template properties and return as array More...

	loadSettingsTypesIntoArray (object $db)
	load template_settings_types and return as array More...

	saveAs (object $db)
	save a template as new. It copies the tpl folder and all settings into a new one. More...

	saveProperties (object $db, int $id, array $data, array $oldTplSettings)
	save new template properties into database More...

	switchPositionIndicators (object $db, int $templateID, int $status)
	switch all positions indicators on or off More...

	uploadTemplate ($db, $postData, $postFiles, $lang)
	Upload a template (install / update) More...

Static Public Member Functions
static	checkWrapper ($lang, $title, $subtitle)
	check if an admin LTE wrapper should be loaded around the backend content. This function must be called at the top of every backend page (admin/includes/xyz.php) More...

static	drawAssetsSelectFields ($db, $type, $templateID, $lang)
	Draw asset select fields. More...

static	drawAssetsTitles ($db, $templateID, $lang)
	Draw a list with all assets that are used in this template. More...

static	getActiveBodyFont ($db, $user, $template)
	Get and return current active google font. More...

static	getActivegfont ($db, $status, $property)
	return currently active google font More...

static	getAllSettingsIntoArray ($db, $user)
	Returns an array with all template settings. More...

static	getAssetsByType ($db, $type)
	Return a multidimensional array with all assets by requested type. More...

static	getCurrentTemplateId (object $db)
	return ID of current (active) template More...

static	getFontsFromFolder ($folder)
	get fonts from folder and return as array More...

static	getGoogleFontsArray ($db)
	get all google fonts into an array and return array More...

static	getMaxId ($db)
	return biggest ID from template database More...

static	getPositionDivBox ($db, $lang, $position, $row, $bootstrapGrid, $positions, $indicators, $user, $template)
	return div box with postition settings More...

static	getPositionIndicatorStatusArray ($db, $templateID)
	get the position indicators. This is used on index.php to mark indicated positions More...

static	getPositionStatesArray ($db, $templateID)
	get the position states of all templates. This is used on index.php to render only templates that are enabled (1) More...

static	getTemplateIds (object $db)
	return array with all template id's + names. More...

static	getTemplateSettingsArray ($db, $templateID)
	get all template settings into an array and return it More...

static	getValidTemplateID ($db, $user, $template)
	check the current template ID, considering if user is logged in, allowed to override template and so on More...

static	includeHeader ($db)
	include header for html page outdated? moved to sys? More...

static	loadGoogleFonts ($db)
	get settings for heading, menu and text font and output html to load font More...

static	returnCurrentBootstrapVersion ($db, $templateID)
	Return which Bootstrap version is currently loaded in given template. More...

static	setCssBodyFontFace ($cssTagName, $tplSettings)
	set css code for custom fonts (ttf / otf / woff) More...

static	setCssBodyFontSettings ($cssTagName, $tplSettings)
	set body font settings css code More...

static	setCssBodyLinkTags ($cssTagName, $tplSettings)
	set css code for body link styling More...

static	setCssBodySmallFontSettings ($cssTagName, $tplSettings)
	set small font settings css code More...

static	setCssFontSettings ($cssTagName, $tplSettings)
	set font settings css code More...

static	setPosition ($db, $lang, $position, $currentpage, $user, $template)
	set template position and output the correct data depending on position More...

Public Attributes
	$active

	$author

	$authorUrl

	$bootstrapVersion

	$config

	$description

	$folder = '../system/templates/'

	$framework = 'bootstrap4'

	$id

	$license

	$modifyDate

	$name

	$newId

	$newTplName

	$positions

	$releaseDate

int	$selectedTemplate

	$subAuthor = ''

	$subAuthorUrl = ''

	$subFolder

	$tmpFolder = '../system/templates/tmp/'

string	$ttfPath = '../system/fonts/'

	$uploadFile = ''

	$version

	$weblink

Detailed Description

The template controller - get and set template settings.

Template controller - get and set template settings.

Templates itself are located in /system/templates/ - if you want to modify them, start there.

Class covers both, backend & frontend functionality. See Methods Summary for Details!

Author: Daniel Retzl danie.nosp@m.lret.nosp@m.zl@gm.nosp@m.ail..nosp@m.com

Copyright: 2009-2022 Daniel Retzl @license https://opensource.org/licenses/MIT

Definition at line 15 of file template.php.

Member Function Documentation

◆ checkIfTemplateAlreadyExists()

YAWK\template::checkIfTemplateAlreadyExists	(	object	$db,
		string	$name
	)

Check if a template with given name already exists, return true or false.

Parameters

object	$db
string	$name

Returns: bool true|false

Definition at line 95 of file template.php.

  : bool
  {
  // check if name is set, not empty and valid type
  if (isset($name) && (!empty($name) && (is_string($name))))
  {
  // strip unwanted code
  $name = strip_tags($name);
  
  // check if template is already in database
  $result = $db->query("SELECT name FROM {templates} WHERE name = '".$name."'");
  // if there are no rows
  if($result->num_rows == 0)
  { // template not found in database...
  sys::setSyslog($db, 45, 0, "template $name not found in database", 0, 0, 0, 0);
  return false;
  }
  else
  { // template exists in database
  sys::setSyslog($db, 45, 0, "template $name updated", 0, 0, 0, 0);
  return true;
  }
  }
  else
  { // template param not set, empty or wrong type
  sys::setSyslog($db, 45, 0, "template param $name not set or wrong type", 0, 0, 0, 0);
  return false;
  }
  }

References $db, YAWK\template\$name, and $result.

Referenced by YAWK\template\uploadTemplate().

◆ checkWrapper()

static YAWK\template::checkWrapper	(	$lang,
		$title,
		$subtitle
	)

static

check if an admin LTE wrapper should be loaded around the backend content. This function must be called at the top of every backend page (admin/includes/xyz.php)

Parameters

array $lang language array

Returns: null

Definition at line 2819 of file template.php.

  {
  /* @var \YAWK\db $db */
  if (!isset($_GET['hideWrapper'])) {
  // draw the admin lte wrapper around content to include breadcrumbs and start content section
  // TEMPLATE WRAPPER - HEADER & breadcrumbs
  echo "
  <!-- Content Wrapper. Contains page content -->
  <div class=\"content-wrapper\" id=\"content-FX\">
  <!-- Content Header (Page header) -->
  <section class=\"content-header\">";
  /* draw Title on top */
  echo \YAWK\backend::getTitle($lang[$title], $lang[$subtitle]);
  echo "<ol class=\"breadcrumb\">
  <li><a href=\"index.php\" title=\"$lang[DASHBOARD]\"><i class=\"fa fa-dashboard\"></i> $lang[DASHBOARD]</a></li>
  <li><a href=\"index.php?page=users\" class=\"active\" title=\"$lang[USERS]\"> $lang[USERS]</a></li>
  </ol>
  </section>
  <!-- Main content -->
  <section class=\"content\">";
  /* page content start here */
  return null;
  } else // if wrapper is set
  { // check if hide status is 1
  if ($_GET['hideWrapper'] === 1) {
  // no wrapper needed - do nothing
  }
  }
  return null;
  }

References $_GET, and $lang.

◆ deleteSettingsCSSFile()

YAWK\template::deleteSettingsCSSFile	(	$db,
		$filename
	)

delete template settings css file

Parameters

object	$db	database
string	$filename	the filename (including path) you wish to delete

Returns: bool

Definition at line 799 of file template.php.

  { // if no filename is given
  if (!isset($filename) || (empty($filename))) { // set default filename
  $filename = self::getSettingsCSSFilename($db, '', '');
  }
  // we want the settings.css file to be overridden, so check if file exists and delete it if needed.
  if (file_exists($filename)) { // if there is a file, delete it.
  if (!unlink($filename)) { // delete failed, throw error
  sys::setSyslog($db, 47, 1, "failed to delete file <b>$filename</b>", 0, 0, 0, 0);
  alert::draw("danger", "Error!", "Failed to unlink $filename<br>Please delete this file and check file / folder / owner or group permissions!", "", 6200);
  return false;
  } else { // delete worked
  return true;
  }
  } else { // file does not exist
  sys::setSyslog($db, 47, 1, "failed to delete settings css file because it does not exist.", 0, 0, 0, 0);
  return true;
  }
  }

References $db, $filename, and YAWK\alert\draw().

◆ downloadTemplate()

YAWK\template::downloadTemplate	(	$db,
		$templateFolder,
		$templateID,
		$user
	)

Create a zip file from template and force direct download.

Parameters

object	$db	database
string	$templateFolder	the template folder to zip + download
int	$templateID	ID of the template to process
object	$user	user object

Returns: bool true|false

dump database settings into .json files, write template.ini and license file, zip the whole template folder and serve .zip for direct download

Definition at line 3714 of file template.php.

  {
  // check if template folder is set and valid
  if (!isset($templateFolder) || (empty($templateFolder) || (!is_string($templateFolder))))
  { // required param not set
  return false;
  }
  else
  { // set template folder property
  $this->subFolder = $templateFolder;
  $this->name = $templateFolder;
  }
  // check if template ID is set and valid
  if (!isset($templateID) || (empty($templateID) || (!is_numeric($templateID))))
  { // required param not set
  return false;
  }
  else
  { // set template ID property
  $this->id = $templateID;
  }
  
  if (!is_dir(dirname($this->tmpFolder)))
  {
  // check if tmp directory exists...
  if (!mkdir(dirname($this->tmpFolder)))
  { // failed to create tmp folder
  // todo: add syslog entry
  return false;
  }
  }
  
  // params are set, next step:
  // check if tmp directory exists and is empty
  if (is_writeable(dirname($this->tmpFolder)))
  {
  // check if subfolder exists...
  if (!is_dir(dirname($this->tmpFolder.$this->subFolder)))
  {
  // check if tmp directory exists...
  if (!mkdir(dirname($this->tmpFolder.$this->subFolder)))
  { // failed to create tmp sub folder
  sys::setSyslog($db, 47, 0, "failed to create ".$this->tmpFolder.$this->subFolder."", 0, 0, 0, 0);
  return false;
  }
  }
  
  // next step is to copy the whole template folder into tmp folder
  if (sys::xcopy($this->folder.$this->subFolder."/", $this->tmpFolder.$this->subFolder) === false)
  { // failed to copy template into tmp folder
  sys::setSyslog($db, 47, 0, "failed to copy template into tmp folder: ".$this->tmpFolder.$this->subFolder."", 0, 0, 0, 0);
  return false;
  }
  
  // check if template folder is writeable
  if (is_writeable($this->tmpFolder.$this->subFolder))
  {
  // GET TEMPLATE DEPENDING DATABASE DATA
  // get current template data
  $templateData = self::loadPropertiesIntoArray($db, $this->id);
  $templateAssets = self::loadActiveAssetsIntoArray($db, $this->id);
  $templateSettings = self::loadAllSettingsIntoArray($db, $this->id);
  $templateSettingsTypes = self::loadSettingsTypesIntoArray($db);
  
  // encode arrays to JSON format
  $templateData = json_encode($templateData);
  $templateAssets = json_encode($templateAssets);
  $templateSettings = json_encode($templateSettings);
  $templateSettingsTypes = json_encode($templateSettingsTypes);
  
  // write json arrays into files
  // write templates.json
  if (!file_put_contents($this->tmpFolder.$this->subFolder."/"."templates.json", $templateData))
  { // error writing templates.json
  sys::setSyslog($db, 48, 0, "failed to write ".$this->tmpFolder.$this->subFolder."templates.json", 0, 0, 0, 0);
  }
  // write assets.json
  if (!file_put_contents($this->tmpFolder.$this->name."/"."assets.json", $templateAssets))
  { // error writing assets.json
  sys::setSyslog($db, 48, 0, "failed to write ".$this->tmpFolder.$this->subFolder."assets.json", 0, 0, 0, 0);
  }
  // write template_settings.json
  if (!file_put_contents($this->tmpFolder.$this->name."/"."template_settings.json", $templateSettings))
  { // error writing template_settings.json
  sys::setSyslog($db, 48, 0, "failed to write ".$this->tmpFolder.$this->subFolder."template_settings.json", 0, 0, 0, 0);
  }
  // write template_settings_types.json
  if (!file_put_contents($this->tmpFolder.$this->name."/"."template_settings_types.json", $templateSettingsTypes))
  { // error writing template_settings_types.json
  sys::setSyslog($db, 48, 0, "failed to write ".$this->tmpFolder.$this->subFolder."template_settings_types.json", 0, 0, 0, 0);
  }
  
  // get template properties
  $this->loadProperties($db, $this->id);
  // get year only from release date
  $year = (substr($this->releaseDate, 0, 4));
  // include class
  require_once('../system/classes/licenses.php');
  // create license object
  $license = new \YAWK\licenses($this->license, $this->description, $year, $this->author, $this->tmpFolder.$this->name."/");
  // write license file
  if ($license->writeLicenseFile() === false)
  { // failed to write license file
  sys::setSyslog($db, 47, 0, "failed to write license file ($this->license license) to ".$this->tmpFolder.$this->subFolder."", 0, 0, 0, 0);
  }
  }
  
  // check if .json files have been written...
  if (is_file($this->tmpFolder.$this->subFolder.'/assets.json')
  && (is_file($this->tmpFolder.$this->subFolder.'/templates.json')
  && (is_file($this->tmpFolder.$this->subFolder.'/template_settings.json')
  && (is_file($this->tmpFolder.$this->subFolder.'/template_settings_types.json')))))
  {
  // ok, all files seem to be processed successfully
  
  // set source (path to the affected template)
  $source = $this->tmpFolder;
  // set target (path to the zip file that will be generated)
  $destination = $this->tmpFolder.$this->name.'.zip';
  
  // set data for ini file
  $iniData['DATE'] = sys::now();
  $iniData['NAME'] = $this->name;
  $iniData['FOLDER'] = $this->folder;
  $iniData['SUBFOLDER'] = $this->subFolder;
  $iniData['TARGET_PATH'] = $this->folder.$this->subFolder."/";
  $iniData['ID'] = $this->id;
  $iniData['FRAMEWORK'] = $this->framework;
  $iniData['DESCRIPTION'] = $this->description;
  $iniData['AUTHOR'] = $this->author;
  $iniData['AUTHOR_URL'] = $this->authorUrl;
  $iniData['SUB_AUTHOR'] = $this->subAuthor;
  $iniData['SUB_AUTHOR_URL'] = $this->subAuthorUrl;
  $iniData['WEBLINK'] = $this->weblink;
  $iniData['VERSION'] = $this->version;
  $iniData['LICENSE'] = $this->license;
  
  // write ini file
  if (sys::writeIniFile($iniData, $this->tmpFolder."template.ini") === false)
  {
  // failed to write ini file:
  sys::setSyslog($db, 47, 0, "failed to write ".$this->tmpFolder."template.ini ", 0, 0, 0, 0);
  return false;
  }
  
  // next step is to zip the whole template folder, containing all files
  
  // check if zip extension is loaded
  if (extension_loaded('zip'))
  {
  // make sure $source (template folder) exists
  if (!is_dir(dirname($source)))
  { // if folder does not exist
  return false;
  }
  
  // create new zip object
  $zip = new \ZipArchive();
  
  // make sure to create and open new zip archive
  if (!$zip->open($destination, \ZIPARCHIVE::CREATE))
  { // if not
  return false;
  }
  
  // set path slashes correctly
  $source = str_replace('\\', '/', realpath($source));
  
  // check if $source is a directoy
  if (is_dir($source) === true)
  {
  // run recursive iterators to store files in array
  $elements = new \RecursiveIteratorIterator(new \RecursiveDirectoryIterator($source), \RecursiveIteratorIterator::SELF_FIRST);
  
  // walk through folder
  foreach ($elements as $file)
  {
  // set path slashes correctly
  $file = str_replace('\\', '/', $file);
  
  // ignore dot folders (. and ..)
  if( in_array(substr($file, strrpos($file, '/')+1), array('.', '..')) )
  continue;
  
  // set file including path
  $file = realpath($file);
  
  // check if current element is a directory
  if (is_dir($file) === true)
  { // add folder to zip file
  $zip->addEmptyDir(str_replace($source . '/', '', $file . '/'));
  }
  // check if current element is a file
  else if (is_file($file) === true)
  { // add file to zip archive
  $zip->addFromString(str_replace($source . '/', '', $file), file_get_contents($file));
  }
  }
  }
  // if $source is a file
  else if (is_file($source) === true)
  { // add file to zip archive
  $zip->addFromString(basename($source), file_get_contents($source));
  }
  
  // all done, close (and write) zip archive
  $zip->close();
  
  if (is_file($destination))
  { // destination zip file is there.
  
  // delete all files from tmp folder - except the created zipfile
  if (\YAWK\filemanager::recursiveRemoveDirectory($this->tmpFolder.$this->subFolder) === false)
  { // warning: failed to delete tmp files
  sys::setSyslog($db, 47, 0, "failed to delete tmp folder ".$this->tmpFolder.$this->subFolder."", 0, 0, 0, 0);
  // return false;
  }
  
  // check if template ID is set
  if (isset($_GET['id']) && (!empty($_GET['id'])))
  { // set var for JS: downloadArchiveLink (selector)
  $downloadTemplateLink = "#downloadTemplateLink-".$_GET['id'];
  // set var for JS: link to the file to download
  $downloadFile = $destination;
  // dirty lil piece of JS code to emulate the user's click
  // (this avoids that he have to click twice - 1st click to generate + 2nd click to download)
  echo "
  <script type='text/javascript'>
  $(document).ready(function()
  { // change href attribute for this archive to direct donwload file
  var oldLink = $('$downloadTemplateLink').attr('href');
  $('$downloadTemplateLink').attr('href', '$downloadFile')
  // emulate a users click to force direct download
  $('$downloadTemplateLink')[0].click();
  // if this is not working, the user have to click on that link.
  });
  </script>";
  }
  // download file generated, direct download forced...
  return true;
  }
  else
  { // zip not generated
  sys::setSyslog($db, 52, 2, "failed to create template $this->name.zip package - zip file not there", 0, 0, 0, 0);
  return false;
  }
  }
  else
  { // zip extension is not loaded
  sys::setSyslog($db, 52, 2, "failed to create template .zip package: PHP zip extension not loaded.", 0, 0, 0, 0);
  return false;
  }
  }
  else
  { // .sql files not written
  sys::setSyslog($db, 52, 2, ".json files missing: $this->folder$this->subFolder/*.json not found", 0, 0, 0, 0);
  return false;
  }
  }
  else
  { // unable to include class
  sys::setSyslog($db, 52, 2, "create template .zip package failed: folder $this->folder is not writeable. Please check folder group permissions", 0, 0, 0, 0);
  return false;
  }
  }

References $_GET, YAWK\template\$author, YAWK\template\$authorUrl, $db, YAWK\template\$description, YAWK\template\$folder, YAWK\template\$framework, YAWK\template\$id, YAWK\template\$license, YAWK\template\$name, YAWK\template\$subAuthor, YAWK\template\$subAuthorUrl, YAWK\template\$subFolder, $templateID, $templateSettings, YAWK\template\$tmpFolder, YAWK\template\$version, YAWK\template\$weblink, description, YAWK\template\loadActiveAssetsIntoArray(), YAWK\template\loadAllSettingsIntoArray(), YAWK\template\loadProperties(), YAWK\template\loadPropertiesIntoArray(), YAWK\template\loadSettingsTypesIntoArray(), name, YAWK\sys\now(), YAWK\filemanager\recursiveRemoveDirectory(), YAWK\sys\writeIniFile(), and YAWK\sys\xcopy().

◆ drawAssetsSelectFields()

static YAWK\template::drawAssetsSelectFields	(	$db,
		$type,
		$templateID,
		$lang
	)

static

Draw asset select fields.

This method is used in the backend to generate asset select fields in template-assets view

Parameters

object	$db	database object
int	$type	0 = all, 1 = required, 2 = optional, 3 = additional
int	$templateID	id of the affected template
array	$lang	language array

Returns: null

Definition at line 2947 of file template.php.

  {
  /* @var \YAWK\db $db */
  
  // check type and load assets data
  // if type is not set
  if (!isset($type) || (empty($type))) { // set to zero -this will get all assets in array
  $type = 0;
  }
  
  // check if templateID is set
  if (!isset($templateID) || (empty($templateID))) {
  // get current template ID
  $templateID = settings::getSetting($db, "selectedTemplate");
  }
  
  // get assets, depending on type from database
  $assets = template::getAssetsByType($db, $type);
  
  foreach ($assets as $asset => $property) {
  $resInternal = $db->query("SELECT link from {assets} 
  WHERE templateID = '" . $templateID . "'
  AND link = '" . $property['internal'] . "'");
  
  $resUrl1 = $db->query("SELECT link from {assets} 
  WHERE templateID = '" . $templateID . "'
  AND link = '" . $property['url1'] . "'");
  
  $resUrl2 = $db->query("SELECT link from {assets} 
  WHERE templateID = '" . $templateID . "'
  AND link = '" . $property['url2'] . "'");
  
  $resUrl3 = $db->query("SELECT link from {assets} 
  WHERE templateID = '" . $templateID . "'
  AND link = '" . $property['url3'] . "'");
  
  $row = mysqli_fetch_assoc($resInternal);
  if (isset($property['internal']) && isset($row['link']) && $row['link'] === $property['internal']) {
  $selectedInternal = " selected";
  } else {
  $selectedInternal = '';
  }
  
  $row = mysqli_fetch_assoc($resUrl1);
  if (isset($property['url1']) && isset($row['link']) && $row['link'] === $property['url1']) {
  $selectedUrl1 = " selected";
  } else {
  $selectedUrl1 = '';
  }
  
  $row = mysqli_fetch_assoc($resUrl2);
  // echo "<br>VAR : "; // print_r($property);
  if (isset($property['url2']) && isset($row['link']) && $row['link'] === $property['url2']) {
  $selectedUrl2 = " selected";
  } else {
  $selectedUrl2 = '';
  }
  
  $row = mysqli_fetch_assoc($resUrl3);
  if (isset($property['url3']) && isset($row['link']) && $row['link'] === $property['url3']) {
  $selectedUrl3 = " selected";
  } else {
  $selectedUrl3 = '';
  }
  
  echo "<label for=\"include-$property[property]\">$property[asset]</label>
  <input name=\"title-$property[property]\" value=\"$property[asset]\" type=\"hidden\">
  <input name=\"sortation-$property[property]\" value=\"$property[sortation]\" type=\"hidden\">
  
  <select id=\"include-$property[property]\" name=\"include-$property[property]\" class=\"form-control\">
  <option name=\"null\" value=\"\">inactive</option>
  <optgroup label=\"internal\">internal</optgroup>
  <option name=\"value\"$selectedInternal>$property[internal]</option>
  <optgroup label=\"external\">external</optgroup>
  <option name=\"value\"$selectedUrl1>$property[url1]</option>";
  if (!empty($property['url2'])) { // display 2nd external asset link
  echo "
  <option name=\"value\"$selectedUrl2>$property[url2]</option>";
  }
  if (!empty($property['url3'])) {
  echo "
  <option name=\"value\"$selectedUrl3>$property[url3]</option>";
  }
  echo "
  </select>";
  }
  return null;
  }

References $db, $templateID, $type, YAWK\template\getAssetsByType(), and YAWK\settings\getSetting().

◆ drawAssetsTitles()

static YAWK\template::drawAssetsTitles	(	$db,
		$templateID,
		$lang
	)

static

Draw a list with all assets that are used in this template.

Parameters

object	$db	database object
int	$templateID	ID of the affectd template
array	$lang	language array

Returns: null

Definition at line 2909 of file template.php.

  {
  /* @var \YAWK\db $db */
  // if no template ID is set
  if (!isset($templateID) || (empty($templateID))) { // get current ID from database
  $templateID = settings::getSetting($db, "selectedTemplate");
  }
  if ($res = $db->query("SELECT asset, link FROM {assets} 
  WHERE templateID = '" . $templateID . "' 
  ORDER BY asset")
  ) {
  while ($row = mysqli_fetch_assoc($res)) {
  // check, if link is external
  if (strpos($row['link'], 'http://') !== false || (strpos($row['link'], 'https://') !== false)) {
  $icon = "fa fa-cloud";
  $title = "$lang[EXTERNAL]";
  } else {
  $icon = "fa fa-server";
  $title = "$lang[INTERNAL]";
  }
  $qString = rawurlencode($row['asset']);
  
  echo "<small><a href=\"index.php?page=template-assets\" data-toggle=\"tooltip\" title=\"$title\"><i class=\"$icon text-info\"></i></a></small> &nbsp;$row[asset] &nbsp;<small><a href=\"https://www.google.at/search?q=$qString\" target=\"_blank\" data-toggle=\"tooltip\" title=\"$row[asset] $lang[GOOGLE_THIS]\"><i class=\"fa fa-question-circle-o\"></i></a></small><br>";
  }
  }
  return null;
  }

References $db, $res, $templateID, and YAWK\settings\getSetting().

◆ drawFontFamilySelectField()

YAWK\template::drawFontFamilySelectField	(	$db,
		$lang,
		$selectName,
		$defaultValue
	)

return a select option list with all fonts:

system default fonts
own true type fonts from system/fonts
google fonts from database: gfonts

Parameters

object	$db	database
string	$selectName	selectName
array	$lang	language array

Definition at line 1841 of file template.php.

  {
  if (isset($defaultValue) && (!empty($defaultValue))) {
  $defaultValueOption = "<option value=\"$defaultValue\" selected aria-selected=\"true\">$defaultValue</option>";
  } else {
  $defaultValueOption = '';
  }
  $selectField = ''; // init var to hold select field html code
  $selectField =
  "
  <select style=\"margin-bottom:10px;\" id=\"$selectName\" name=\"$selectName\" class=\"form-control\">
  $defaultValueOption;
  <optgroup label=\"System Sans-Serif Fonts\"></optgroup>
  <option value=\"Arial, Helvetica, sans-serif\">&nbsp;&nbsp;Arial, Helvetica, sans-serif</option>
  <option value=\"Arial Black\">&nbsp;&nbsp;Arial Black</option>
  <option value=\"Comic Sans MS, cursive, sans-serif\">&nbsp;&nbsp;Comic Sans</option>
  <option value=\"Impact, Charcoal, sans-serif\">&nbsp;&nbsp;Impact, Charcoal, sans-serif</option>
  <option value=\"Lucida Sans Unicode, Lucida Grande, sans-serif\">&nbsp;&nbsp;Lucida Sans Unicode, Lucida Grande, sans-serif</option>
  <option value=\"Tahoma, Geneva, sans-serif\">&nbsp;&nbsp;Tahoma, Geneva, sans-serif</option>
  <option value=\"Trebuchet MS, Helvetica, sans-serif\">&nbsp;&nbsp;Trebuchet MS, Helvetica, sans-serif</option>
  <option value=\"Verdana, Geneava, sans-serif\">&nbsp;&nbsp;Verdana, Geneava, sans-serif</option>
  <optgroup label=\"System Serif Fonts\"></optgroup>
  <option value=\"Georgia, serif\">&nbsp;&nbsp;Georgia, serif</option>
  <option value=\"Palatino Linotype, Book Antiqua, Palatino, serif\">&nbsp;&nbsp;Palatino Linotype, Book Antiqua, Palatino, serif</option>
  <option value=\"Times New Roman, Times, serif\">&nbsp;&nbsp;Times New Roman, Times, serif</option>
  <optgroup label=\"System Monospace Fonts\"></optgroup>
  <option value=\"Courier New, Courier, monospace\">&nbsp;&nbsp;Courier New, Courier, monospace</option>
  <option value=\"Lucida Console, Monaco, monospace\">&nbsp;&nbsp;Lucida Console, Monaco, monospace</option>";
  
  // directory iterator walks trough system/fonts
  // and build up 3 arrays: ttf fonts, otf fonts and woff fonts
  // afterwards they get processed and drawn
  if (is_dir($this->ttfPath)) // only if directory exists, otherwise skip
  {
  $dir = new \DirectoryIterator($this->ttfPath);
  $ttfFonts = array(); // all .ttf files
  $otfFonts = array(); // all .otf files
  $woffFonts = array(); // all .woff files
  
  foreach ($dir as $item) {
  if (!$item->isDot()
  && (!$item->isDir())
  ) {
  // workaround: todo what about filenames with spaces?
  // check if it is a true type file
  if (strtolower(substr($item, -3)) === "ttf") {
  // workaround: if dots are in there, the form does not work.
  // so lets change the dots to '-' and let option pass trough
  $item = str_replace(".", "-", $item);
  // add ttf font to array
  $ttfFonts[] = "<option value=\"$item\">&nbsp;&nbsp;$item</option>";
  }
  // check if it is a otf file
  if (strtolower(substr($item, -3)) === "otf") {
  $item = str_replace(".", "-", $item);
  // add option to select field
  $otfFonts[] = "<option value=\"$item\">&nbsp;&nbsp;$item</option>";
  }
  // check if it is a woff file
  if (strtolower(substr($item, -4)) === "woff") {
  // workaround: change dots to '-' to let option pass trough
  $item = str_replace(".", "-", $item);
  // add option to select field
  $woffFonts[] = "<option value=\"$item\">&nbsp;&nbsp;$item</option>";
  }
  }
  } // end if is_dir
  
  // add .ttf fonts to select option
  $selectField .= "<optgroup label=\"True Type Fonts (system/fonts/*.ttf)\"></optgroup>";
  foreach ($ttfFonts as $ttfFont) { // add ttf option to select field
  $selectField .= $ttfFont;
  }
  // add .otf fonts to select option
  $selectField .= "<optgroup label=\"Open Type Fonts (system/fonts/*.otf)\"></optgroup>";
  foreach ($otfFonts as $otfFont) { // add ttf option to select field
  $selectField .= $otfFont;
  }
  // add .woff fonts to select option
  $selectField .= "<optgroup label=\"Web Open Font Format (system/fonts/*.woff)\"></optgroup>";
  foreach ($woffFonts as $woffFont) { // add ttf option to select field
  $selectField .= $woffFont;
  }
  }
  
  
  // fill google fonts array
  $googleFonts = $this->getGoogleFontsArray($db);
  // add google fonts to select option
  $selectField .= "<optgroup label=\"Google Fonts\"></optgroup>";
  foreach ($googleFonts as $gFont) {
  // add google font option to select field
  // add option to select field
  $selectField .= "<option value=\"$gFont-gfont\">&nbsp;&nbsp;$gFont (Google Font)</option>";
  }
  // close select option
  $selectField .= "</select>";
  
  // finally: output the html code of this select field
  return $selectField;
  }

References $googleFonts, $item, and YAWK\template\getGoogleFontsArray().

Referenced by YAWK\template\getFontRow().

◆ emptyTmpFolder()

YAWK\template::emptyTmpFolder ( )

Definition at line 3245 of file template.php.

  {
  foreach(glob($this->tmpFolder."*") as $file)
  {
  if(!is_dir($file))
  {
  unlink($file);
  }
  else
  {
  \YAWK\filemanager::recursiveRemoveDirectory($file);
  }
  }
  }

References YAWK\filemanager\recursiveRemoveDirectory().

Referenced by YAWK\template\uploadTemplate().

◆ getActiveBodyFont()

static YAWK\template::getActiveBodyFont	(	$db,
		$user,
		$template
	)

static

Get and return current active google font.

Parameters

$db

Returns: string

Definition at line 2481 of file template.php.

  {
  /* @var \YAWK\db $db */
  $bodyFont = template::getTemplateSetting($db, "value", "globaltext-fontfamily", $user, $template);
  $bodyFontFamily = "font-family: $bodyFont";
  return $bodyFontFamily;
  }

References $db.

◆ getActivegfont()

static YAWK\template::getActivegfont	(	$db,
		$status,
		$property
	)

static

return currently active google font

Parameters

object	$db	database
string	$status	the url or font name
string	$property	affected settings property

Returns: null|string

Definition at line 2496 of file template.php.

  {
  /* @var \YAWK\db $db */
  if ($res = $db->query("SELECT id, font, setting
  FROM {gfonts}
  WHERE activated = 1
  AND id = (SELECT ts.value
  FROM {template_settings} ts
  JOIN {settings} s on s.value = ts.templateID
  WHERE ts.activated = 1 && s.property = 'selectedTemplate' && ts.property = '$property')")
  ) {
  while ($row = mysqli_fetch_array($res)) {
  // if no google font is selected
  if ($row[1] === "0") {
  return "font-family: Arial";
  }
  // css include output for index.php
  if ($status == "url") {//
  if (isset($row[2]) || (!empty($row[2]))) {
  return "
 <link rel=\"stylesheet\" href=\"http://fonts.googleapis.com/css?family=$row[1]:$row[2]\" type=\"text/css\" media=\"all\">";
  } else {
  return "
 <link rel=\"stylesheet\" href=\"http://fonts.googleapis.com/css?family=$row[1]\" type=\"text/css\" media=\"all\">";
  }
  } else {
  return "font-family: $row[1];";
  }
  }
  } else { // could not get active google font
  return "could not get active google font";
  }
  return null;
  }

References $db, and $res.

◆ getAllSettingsIntoArray()

static YAWK\template::getAllSettingsIntoArray	(	$db,
		$user
	)

static

Returns an array with all template settings.

Parameters

object	$db	Database Object
object	$user	User Object

Returns: array|bool

Definition at line 1061 of file template.php.

  {
  if (!isset($user) || empty($user))
  {
  $user = new user($db);
  }
  // get template settings
  if (isset($user))
  { // get template settings for this user
  if ($user->overrideTemplate == 1) {
  $sql = "SELECT ts.property, ts.value, ts.longValue, ts.valueDefault, ts.type, ts.label, ts.sort, ts.fieldClass, ts.fieldType, ts.placeholder, ts.description, ts.options, ts.activated, ts.icon, ts.heading, ts.subtext
  FROM {template_settings} ts
  JOIN {users} u on u.templateID = ts.templateID
  WHERE ts.activated = 1 && u.id = $user->id
  ORDER BY ts.sort";
  } else {
  $sql = "SELECT ts.property, ts.value, ts.longValue, ts.valueDefault, ts.type, ts.label, ts.sort, ts.fieldClass, ts.fieldType, ts.placeholder, ts.description, ts.options, ts.activated, ts.icon, ts.heading, ts.subtext
  FROM {template_settings} ts
  JOIN {settings} s on s.value = ts.templateID
  WHERE ts.activated = 1 && s.property = 'selectedTemplate'
  ORDER BY ts.sort";
  }
  } else {
  sys::setSyslog($db, 47, 1, "failed to get template settings array - user is not set or empty", 0, 0, 0, 0);
  return false;
  }
  
  /* @param $db \YAWK\db */
  // if ($res= $db->query("SELECT * FROM {template_settings} ORDER by property"))
  if ($res = $db->query($sql)) {
  $settingsArray = array();
  while ($row = $res->fetch_assoc()) { // fill array
  $settingsArray[$row['property']] = $row;
  }
  } else { // q failed, throw error
  sys::setSyslog($db, 5, 1, "failed to query template settings", 0, 0, 0, 0);
  // \YAWK\alert::draw("warning", "Warning!", "Fetch database error: getSettingsArray failed.","","4800");
  return false;
  }
  
  // check if array has been generated
  if (is_array($settingsArray) && (!empty($settingsArray))) { // all good -
  return $settingsArray;
  } else { // error generating settings array -
  return false;
  }
  }

References $db, $res, and $sql.

◆ getAssetsByType()

static YAWK\template::getAssetsByType	(	$db,
		$type
	)

static

Return a multidimensional array with all assets by requested type.

If no type is set, or type == 0, all assets will be returned.

Parameters

object	$db	database object
int	$type	0 = all, 1 = required, 2 = optional, 3 = additional

Returns: array

Definition at line 2857 of file template.php.

  {
  /* @var \YAWK\db $db */
  // check if type is set
  if (!isset($type) || (empty($type))) { // if its not set, get all assets from db, no matter which type they are
  $typeSQLCode = ''; // terminate db query
  } else { // check if type is a number
  if (is_numeric($type) || (is_int($type))) { // and build additional sql string
  $typeSQLCode = "AND type = '$type'";
  
  // if type is zero, fetch all data
  if ($type === 0) { // terminate db query
  $typeSQLCode = '';
  }
  } else { // type is not a number, get all data
  $typeSQLCode = ''; // terminate db query
  }
  }
  
  // init a new empty array
  $assets = array();
  // get assets from database
  $res = $db->query("SELECT * 
  FROM {assets_types}
  WHERE published = '1' 
  $typeSQLCode ORDER by sortation, asset");
  // fetch data in loop
  while ($row = mysqli_fetch_assoc($res)) { // build assets array
  $prop = $row['asset'];
  $assets[$prop]["asset"] = $prop;
  $assets[$prop]["property"] = $row['property'];
  $assets[$prop]["internal"] = $row['internal'];
  $assets[$prop]["url1"] = $row['url1'];
  $assets[$prop]["url2"] = $row['url2'];
  $assets[$prop]["url3"] = $row['url3'];
  $assets[$prop]["sortation"] = $row['sortation'];
  }
  // check if assets is an array
  if (is_array($assets)) { // all good
  return $assets;
  } else { // error: exit with msg
  die ('unable to return assets array - maybe database is corrupt or missing.');
  }
  }

References $db, $res, $type, and die.

Referenced by YAWK\template\drawAssetsSelectFields().

◆ getCurrentTemplateId()

static YAWK\template::getCurrentTemplateId ( object $db )

static

return ID of current (active) template

Parameters

object $db database object

Returns: int the ID of the currently selected template

Definition at line 73 of file template.php.

  : int
  { // return value of property selectedTemplate from settings db
  // outdated: return \YAWK\settings::getSetting($db, "selectedTemplate");
  
  if (!isset($user)){
  $user = new user($db);
  }
  if (!isset($template)){
  $template = new template();
  }
  
  // since user can override his template, there are more specific checks needed,
  // which template is currently active and which ID we will return. To do that:
  return template::getValidTemplateID($db, $user, $template);
  }

References $db, and YAWK\template\getValidTemplateID().

Referenced by YAWK\sys\checkIfAssetsAreLoaded(), YAWK\menu\display(), YAWK\WIDGETS\BLOG\WIDGET\blogWidget\drawBlogWidget(), and YAWK\template\switchPositionIndicators().

◆ getCustomCSSFile()

YAWK\template::getCustomCSSFile	(	object	$db,
		int	$templateID
	)

return the content of custom.css

Parameters

object	$db	database
int	$templateID	affected template ID

Returns: string the content of custom.css

Definition at line 698 of file template.php.

  : string
  { // get the content from custom.css
  $filename = self::getCustomCSSFilename($db, "backend", $templateID);
  return file_get_contents($filename);
  }

References $db, $filename, and $templateID.

◆ getCustomJSFile()

YAWK\template::getCustomJSFile	(	object	$db,
		int	$templateID
	)

return the content of custom.js

Parameters

object	$db	database
int	$templateID	affected template ID

Returns: string the content of custom.css

Definition at line 710 of file template.php.

  : string
  { // get the content from custom.css
  $filename = self::getCustomJSFilename($db, "backend", $templateID);
  return file_get_contents($filename);
  }

References $db, $filename, and $templateID.

◆ getFontRow()

YAWK\template::getFontRow	(	$db,
		$lang,
		$fontRow,
		$previewClass,
		$templateSettings
	)

return font edit row including preview

Parameters

object	$db	database
array	$lang	language array
string	$fontRow	the prefix of the font group to edit (eg. h1, h2, h3, globaltext...)
string	$previewClass	css class you want to use on the preview
array	$templateSettings	all template settings as an array

Definition at line 1460 of file template.php.

  {
  // prepare vars
  $fontRowSize = "$fontRow-size";
  $fontRowColor = "$fontRow-fontcolor";
  $fontRowFontfamily = "$fontRow-fontfamily";
  $fontRowFontShadowSize = "$fontRow-fontshadowsize";
  $fontRowFontShadowColor = "$fontRow-fontshadowcolor";
  $fontRowFontWeight = "$fontRow-fontweight";
  $fontRowFontStyle = "$fontRow-fontstyle";
  $fontRowTextdecoration = "$fontRow-textdecoration";
  $fontRowALinkColor = "$fontRow-alink";
  $fontRowAHoverColor = "$fontRow-ahover";
  $fontRowAVisitedColor = "$fontRow-avisited";
  $fontRowLinkFontWeight = "$fontRow-linkfontweight";
  $fontRowLinkFontStyle = "$fontRow-linkfontstyle";
  $fontRowLinkTextDecoration = "$fontRow-linktextdecoration";
  $fontRowHoverTextDecoration = "$fontRow-hovertextdecoration";
  $fontRowSmallColor = "$fontRow-smallcolor";
  $fontRowSmallShadowSize = "$fontRow-smallshadowsize";
  $fontRowSmallShadowColor = "$fontRow-smallshadowcolor";
  
  if ($fontRow === "globaltext" xor ($fontRow === "menufont")) {
  $col = 4;
  } else {
  $col = 2;
  }
  
  $FONT_ROW = strtoupper($fontRow);
  $labelFontSize = "TPL_" . $FONT_ROW . "_SIZE";
  $labelFontColor = "TPL_" . $FONT_ROW . "_COLOR";
  $labelSmallColor = "TPL_" . $FONT_ROW . "_SMALLCOLOR";
  
  
  // check if description is set
  // the description will be shown right beside the label as small info icon
  if (isset($templateSettings[$fontRowFontfamily]['description']) && (!empty($templateSettings[$fontRowFontfamily]['description']))) { // L11n
  $fontRowFamilyDesc = $lang[$templateSettings[$fontRowFontfamily]['description']];
  $fontRowFamilyInfoBtn = "&nbsp;<small><i class=\"fa fa-question-circle-o text-info\" data-placement=\"auto right\" data-toggle=\"tooltip\" title=\"$fontRowFamilyDesc\"></i></small>";
  } else {
  $fontRowFamilyInfoBtn = '';
  }
  // check if font family default value is set
  if (isset($templateSettings[$fontRowFontfamily]['valueDefault']) && (!empty($templateSettings[$fontRowFontfamily]['valueDefault']))) { // default values:
  $fontRowFamilyDefault = "<i class=\"h6 small\">default: " . $templateSettings[$fontRowFontfamily]['valueDefault'] . "</i>";
  } else {
  $fontRowFamilyDefault = '';
  }
  
  // check if font size is set
  if (isset($templateSettings[$fontRowSize]['valueDefault']) && (!empty($templateSettings[$fontRowSize]['valueDefault']))) { // default values:
  $fontRowSizeDefault = "<i class=\"h6 small\">(" . $templateSettings[$fontRowSize]['valueDefault'] . ")</i>";
  } else {
  $fontRowSizeDefault = '';
  }
  
  $html = "
  <div class=\"col-md-$col\">
  <div class=\"$previewClass\" id=\"$fontRow-preview\" style=\"height: auto; overflow:hidden; font-size: " . $templateSettings[$fontRowSize]['value'] . "; color: #" . $templateSettings[$fontRowColor]['value'] . ";\">$fontRow Heading</div>
  
  <label for=\"$fontRowFontfamily\">$FONT_ROW $lang[TPL_FONTFAMILY] $fontRowFamilyInfoBtn</label>";
  $html .= $this->drawFontFamilySelectField($db, $lang, "$fontRowFontfamily", $templateSettings[$fontRowFontfamily]['value']);
  $html .= "
  
  <label for=\"$fontRowSize\">$lang[$labelFontSize] $fontRowSizeDefault</label>
  <input style=\"margin-bottom:10px;\" id=\"$fontRowSize\" name=\"$fontRowSize\" value=\"" . $templateSettings[$fontRowSize]['value'] . "\" class=\"form-control\">
  
  <label for=\"$fontRowColor\">$lang[$labelFontColor]</label>
  <input style=\"margin-bottom:10px;\" id=\"$fontRowColor\" name=\"$fontRowColor\" class=\"form-control color\" value=\"" . $templateSettings[$fontRowColor]['value'] . "\">
  
  <label for=\"$fontRowFontShadowSize\">$lang[TPL_FONTSHADOWSIZE]</label>
  <input style=\"margin-bottom:10px;\" id=\"$fontRowFontShadowSize\" name=\"$fontRowFontShadowSize\" class=\"form-control\" value=\"" . $templateSettings[$fontRowFontShadowSize]['value'] . "\" placeholder=\"2px 2px\">
  
  <label for=\"$fontRowFontShadowColor\">$lang[TPL_FONTSHADOWCOLOR]</label>
  <input style=\"margin-bottom:10px;\" id=\"$fontRowFontShadowColor\" name=\"$fontRowFontShadowColor\" value=\"" . $templateSettings[$fontRowFontShadowColor]['value'] . "\" class=\"form-control color\">
  
  <label for=\"$fontRowFontWeight\">$lang[TPL_FONTWEIGHT]</label>
  <select style=\"margin-bottom:10px;\" id=\"$fontRowFontWeight\" name=\"$fontRowFontWeight\" class=\"form-control\">";
  
  $fontweightStyles = array("normal", "bold", "bolder", "lighter", "100", "200", "300", "400 [normal]", "500", "600", "700 [bold]", "800", "900", "initial", "inherit");
  foreach ($fontweightStyles as $weight) {
  $currentFontWeight = "$fontRow-fontweight";
  if ($weight === $templateSettings[$currentFontWeight]['value']) {
  $selected = "selected aria-selected=\"true\"";
  } else {
  $selected = '';
  }
  $html .= "<option value=\"$weight\" $selected>$weight</option>";
  }
  $html .= "</select>
  
  <label for=\"$fontRowFontStyle\">$lang[TPL_FONTSTYLE]</label>
  <select style=\"margin-bottom:10px;\" id=\"$fontRowFontStyle\" name=\"$fontRowFontStyle\" class=\"form-control\">";
  
  $fontStyles = array("normal", "italic", "oblique", "initial", "inherit");
  foreach ($fontStyles as $style) {
  $currentFontStyle = "$fontRow-fontstyle";
  if ($style === $templateSettings[$currentFontStyle]['value']) {
  $selected = "selected aria-selected=\"true\"";
  } else {
  $selected = '';
  }
  $html .= "<option value=\"$style\" $selected>$style</option>";
  }
  
  $html .= "</select>
  
  <label for=\"$fontRowTextdecoration\">$lang[TPL_TEXTDECORATION]</label>
  <select style=\"margin-bottom:10px;\" id=\"$fontRowTextdecoration\" name=\"$fontRowTextdecoration\" class=\"form-control\">";
  
  $textdecorationTypes = array("none", "underline", "overline", "line-through", "intial", "inherit");
  foreach ($textdecorationTypes as $decoration) {
  $currentFontDecoration = "$fontRow-textdecoration";
  if ($decoration === $templateSettings[$currentFontDecoration]['value']) {
  $selected = "selected aria-selected=\"true\"";
  } else {
  $selected = '';
  }
  $html .= "<option value=\"$decoration\" $selected>$decoration</option>";
  }
  $html .= "</select>";
  
  // LINK SETTINGS START HERE
  $html .= "
  
  <label for=\"$fontRowLinkTextDecoration\">$lang[TPL_LINK_TEXTDECORATION]</label>
  <select style=\"margin-bottom:10px;\" id=\"$fontRowLinkTextDecoration\" name=\"$fontRowLinkTextDecoration\" class=\"form-control\">";
  
  foreach ($textdecorationTypes as $decoration) {
  $currentLinkTextDecoration = "$fontRow-linktextdecoration";
  if ($decoration === $templateSettings[$currentLinkTextDecoration]['value']) {
  $selected = "selected aria-selected=\"true\"";
  } else {
  $selected = '';
  }
  $html .= "<option value=\"$decoration\" $selected>$decoration</option>";
  }
  $html .= "</select>
  <label for=\"$fontRow-alink\">$lang[TPL_LINK_COLOR]</label>
  <input style=\"margin-bottom:10px;\" id=\"$fontRow-alink\" name=\"$fontRow-alink\" value=\"" . $templateSettings[$fontRowALinkColor]['value'] . "\" class=\"form-control color\">
  
  <label for=\"$fontRow-avisited\">$lang[TPL_LINK_VISITED_COLOR]</label>
  <input style=\"margin-bottom:10px;\" id=\"$fontRow-avisited\" name=\"$fontRow-avisited\" value=\"" . $templateSettings[$fontRowAVisitedColor]['value'] . "\" class=\"form-control color\"> 
  
  <label for=\"$fontRow-ahover\">$lang[TPL_LINK_HOVER_COLOR]</label>
  <input style=\"margin-bottom:10px;\" id=\"$fontRow-ahover\" name=\"$fontRow-ahover\" value=\"" . $templateSettings[$fontRowAHoverColor]['value'] . "\" class=\"form-control color\"> 
  
  <label for=\"$fontRowLinkFontWeight\">$lang[TPL_LINK_TEXTDECORATION]</label>
  <select style=\"margin-bottom:10px;\" id=\"$fontRowLinkFontWeight\" name=\"$fontRowLinkFontWeight\" class=\"form-control\">";
  
  foreach ($fontweightStyles as $weight) {
  $currentLinkFontWeight = "$fontRow-linkfontweight";
  if ($weight === $templateSettings[$currentLinkFontWeight]['value']) {
  $selected = "selected aria-selected=\"true\"";
  } else {
  $selected = '';
  }
  $html .= "<option value=\"$weight\" $selected>$weight</option>";
  }
  $html .= "</select>
  
  <label for=\"$fontRowLinkFontStyle\">$lang[TPL_LINK_FONTSTYLE]</label>
  <select style=\"margin-bottom:10px;\" id=\"$fontRowLinkFontStyle\" name=\"$fontRowLinkFontStyle\" class=\"form-control\">";
  
  foreach ($fontStyles as $style) {
  $currentLinkFontStyle = "$fontRow-linkfontstyle";
  if ($style === $templateSettings[$currentLinkFontStyle]['value']) {
  $selected = "selected aria-selected=\"true\"";
  } else {
  $selected = '';
  }
  $html .= "<option value=\"$style\" $selected>$style</option>";
  }
  
  $html .= "</select>
  <label for=\"$fontRowHoverTextDecoration\">$lang[TPL_HOVER_TEXTDECORATION]</label>
  <select style=\"margin-bottom:10px;\" id=\"$fontRowHoverTextDecoration\" name=\"$fontRowHoverTextDecoration\" class=\"form-control\">";
  
  foreach ($textdecorationTypes as $decoration) {
  $currentFontDecoration = "$fontRow-hovertextdecoration";
  if ($decoration === $templateSettings[$currentFontDecoration]['value']) {
  $selected = "selected aria-selected=\"true\"";
  } else {
  $selected = '';
  }
  $html .= "<option value=\"$decoration\" $selected>$decoration</option>";
  }
  $html .= "</select>";
  
  
  // SMALL TAG COLOR
  $html .= "<label for=\"$fontRowSmallColor\">$lang[TPL_SMALLCOLOR]</label>
  <input style=\"margin-bottom:10px;\" id=\"$fontRowSmallColor\" name=\"$fontRowSmallColor\" class=\"form-control color\" value=\"" . $templateSettings[$fontRowSmallColor]['value'] . "\">";
  
  // SMALL TAG SHADOW SIZE
  $html .= "<label for=\"$fontRowSmallShadowSize\">$lang[TPL_SMALLSHADOWSIZE]</label>
  <input style=\"margin-bottom:10px;\" id=\"$fontRowSmallShadowSize\" name=\"$fontRowSmallShadowSize\" class=\"form-control\" value=\"" . $templateSettings[$fontRowSmallShadowSize]['value'] . "\" placeholder=\"2px 2px\">";
  // SMALL TAG SHADOW COLOR
  $html .= "<label for=\"$fontRowSmallShadowColor\">$lang[TPL_SMALLSHADOWCOLOR]</label>
  <input style=\"margin-bottom:10px;\" id=\"$fontRowSmallShadowColor\" name=\"$fontRowSmallShadowColor\" value=\"" . $templateSettings[$fontRowSmallShadowColor]['value'] . "\" class=\"form-control color\">";
  
  // end font div box
  $html .= "
  </div>";
  
  echo $html;
  
  }

References $col, $lang, $templateSettings, and YAWK\template\drawFontFamilySelectField().

◆ getFontsFromFolder()

static YAWK\template::getFontsFromFolder ( $folder )

static

get fonts from folder and return as array

Parameters

string $folder folder that helds all fonts (usually ../system/fonts/)

Returns: string | array

Definition at line 1674 of file template.php.

  {
  // if no folder is given
  if (!isset($folder) || (empty($folder))) { // set default folder
  $folder = '../system/fonts/';
  } else {
  // make sure that there is a slash at the end
  $folder = rtrim($folder, '/') . '/';
  // check if folder is a directory
  if (!is_dir($folder)) { // if not, abort
  return "Folder <b>$folder</b> is not a valid folder";
  }
  }
  
  // create new font array
  $fontArray = array();
  // create new directory iterator
  $iterator = new \DirectoryIterator($folder);
  // walk through folder
  foreach ($iterator as $file) {
  // exclude dots
  if (!$file->isDot()) { // check filetype
  if ($file->getExtension() === "ttf") { // add ttf fonts to array
  $fontArray['ttf'][] = $file->getFilename();
  }
  // check filetype
  if ($file->getExtension() === "otf") { // add otf fonts to array
  $fontArray['otf'][] = $file->getFilename();
  }
  // check filetype
  if ($file->getExtension() === "woff") { // add woff fonts to array
  $fontArray['woff'][] = $file->getFilename();
  }
  // check filetype
  if ($file->getExtension() === "WOFF") { // add woff fonts to array
  $fontArray['woff'][] = $file->getFilename();
  }
  }
  }
  // check if font array is set and not empty
  if (is_array($fontArray) && (!empty($fontArray))) { // all good
  return $fontArray;
  } else { // array not set or empty, throw message
  return "No fonts found in $folder";
  }
  }

References YAWK\template\$folder, and $fontArray.

◆ getFormElements()

YAWK\template::getFormElements	(	$db,
		$settings,
		$type,
		$lang,
		$user
	)

return html form field, depending on fieldClass

Parameters

object $db Database Object

Definition at line 1163 of file template.php.

  { // loop trough array
  // removed not needed checkup
  if (!isset($type) && (empty($type)))
  { // if param 'type' is missing, set type 1 as default
  $type = 1;
  }
  if (!isset($settings) || (is_array($settings) === false))
  {
  echo 'Template settings are missing. Please re-install template.';
  }
  else
  {
  // loop trough settings array
  foreach ($settings as $setting)
  {
  // field type not set or empty
  if (!isset($setting['fieldType']) && (empty($fieldType)))
  { // set input field as common default
  $setting['fieldType'] = "input";
  }
  else
  { // settings type must be equal to param $type
  // equals settings category
  if ($setting['type'] === "$type" && ($setting['activated'] === "1"))
  {
  // check if ICON is set
  // if an icon is set, it will be drawn before the heading, to the left.
  if (isset($setting['icon']) && (!empty($setting['icon'])))
  { // fill it w icon
  $setting['icon'] = "<i class=\"$setting[icon]\"></i>";
  }
  else
  { // leave empty - no icon available
  $setting['icon'] = '';
  }
  
  // check if LABEL is set
  // The label sits directly above, relative to the setting form element
  if (isset($setting['label']) && (!empty($setting['label'])))
  { // if its set, put it into $lang array for L11n
  $setting['label'] = $lang[$setting['label']];
  }
  else
  { // otherwise throw error
  $setting['label'] = 'sorry, there is not label set. meh!';
  }
  
  // check if HEADING is set
  // if set, a <H3>Heading</H3> will be shown above the setting
  if (isset($setting['heading']) && (!empty($setting['heading'])))
  { // L11n
  $setting['heading'] = $lang[$setting['heading']];
  }
  else
  { // leave empty - no heading for that setting
  $setting['heading'] = '';
  }
  
  // check if SUBTEXT is set
  // this is shown in <small>tags</small> beneath the heading
  if (isset($setting['subtext']) && (!empty($setting['subtext'])))
  { // L11n
  $setting['subtext'] = $lang[$setting['subtext']];
  }
  else
  { // leave empty - no subtext beneath the heading
  $setting['subtext'] = '';
  }
  
  // check if description is set
  // the description will be shown right beside the label
  if (isset($setting['description']) && (!empty($setting['description'])))
  { // L11n
  $setting['description'] = $lang[$setting['description']];
  $setting['description'] = "&nbsp;<small><i class=\"fa fa-question-circle-o text-info\" data-placement=\"auto right\" data-toggle=\"tooltip\" title=\"$setting[description]\"></i></small>";
  }
  
  /* SELECT FIELD */
  if ($setting['fieldType'] === "select")
  { // display icon, heading and subtext, if its set
  if (!empty($setting['icon']) || (!empty($setting['heading']) || (!empty($setting['subtext']))))
  {
  echo "<br><h4 class=\"box-title\">$setting[icon]&nbsp;$setting[heading]&nbsp;<small>$setting[subtext]</small></h4>";
  }
  // begin draw select
  echo "<label for=\"$setting[property]\">$setting[label]&nbsp;$setting[description]&nbsp;
  <small><i class=\"small\" style=\"font-weight:normal\">$lang[DEFAULT]: $setting[valueDefault]</i></small></label>
  <select style=\"margin-bottom:10px;\" class=\"form-control\" id=\"$setting[property]\" name=\"$setting[property]\">";
  echo "<option value=\"$setting[value]\">$lang[SETTING_CURRENT] $setting[value]</option>";
  // explode option string into array
  $optionValues = explode(":", $setting['options']);
  foreach ($optionValues as $value)
  {
  // extract value from option setting string
  // $optionValue = preg_replace("/,[a-zA-Z0-9]*/", "", $value);
  // extract description from option setting
  $optionDesc = preg_replace('/.*,(.*)/', '$1', $value);
  $optionValue = preg_split("/,[a-zA-Z0-9]*/", $value);
  
  echo "<option value=\"$optionValue[0]\">$optionDesc</option>";
  }
  echo "</select>";
  }
  
  /* RADIO BUTTTONS */
  else if ($setting['fieldType'] === "radio")
  {
  if (!empty($setting['icon']) || (!empty($setting['heading']) || (!empty($setting['subtext']))))
  {
  echo "<br><h4 class=\"box-title\">$setting[icon]&nbsp;$setting[heading]&nbsp;<small>$setting[subtext]</small></h4>";
  }
  echo "<label for=\"$setting[property]\">$setting[label]&nbsp;$setting[description]&nbsp;</label>
  <input style=\"margin-bottom:10px;\" type=\"radio\" id=\"$setting[property]\" name=\"$setting[property]\">";
  echo "<input type=\"radio\" value=\"$setting[value]\">$lang[SETTING_CURRENT] $setting[value]</option>";
  
  // explode option string into array
  $optionValues = explode(":", $setting['options']);
  foreach ($optionValues as $value)
  {
  // extract value from option setting string
  $optionValue = preg_replace("/,[a-zA-Z0-9]*/", "", $value);
  // extract description from option setting
  $optionDesc = preg_replace('/.*,(.*)/', '$1', $value);
  
  echo "<option value=\"$optionValue\">$optionDesc</option>";
  }
  echo "</select>";
  }
  
  // CHECKBOX
  else if ($setting['fieldType'] === "checkbox")
  { // build a checkbox
  if ($setting['value'] === "1")
  { // set checkbox to checked
  $checked = "checked";
  }
  else
  { // checkbox not checked
  $checked = "";
  }
  if (!empty($setting['icon']) || (!empty($setting['heading']) || (!empty($setting['subtext']))))
  {
  echo "<br><h4 class=\"box-title\">$setting[icon]&nbsp;$setting[heading]&nbsp;<small>$setting[subtext]</small></h4>";
  }
  echo "<input type=\"hidden\" name=\"$setting[property]\" value=\"0\">
  <input type=\"checkbox\" id=\"$setting[property]\" name=\"$setting[property]\" value=\"1\" $checked>
  <label style=\"margin-bottom:10px;\" for=\"$setting[property]\">&nbsp; $setting[label]&nbsp;$setting[description]&nbsp;</label>";
  }
  
  // CHECKBOX as toggle switch
  else if ($setting['fieldType'] === "checkbox toggle")
  {
  // build a checkbox
  if ($setting['value'] === "1")
  { // set checkbox to checked
  $checked = "checked";
  }
  else
  { // checkbox not checked
  $checked = "";
  }
  
  if (!empty($setting['icon']) || (!empty($setting['heading']) || (!empty($setting['subtext']))))
  {
  echo "<br><h4 class=\"box-title\">$setting[icon]&nbsp;$setting[heading]&nbsp;<small>$setting[subtext]</small></h4>";
  }
  echo "<input type=\"hidden\" name=\"$setting[property]\" value=\"0\">
  <input type=\"checkbox\" data-on=\"$lang[ON_]\" data-off=\"$lang[OFF_]\" data-toggle=\"toggle\" data-onstyle=\"success\" data-offstyle=\"danger\" id=\"$setting[property]\" name=\"$setting[property]\" value=\"1\" $checked>
  <label for=\"$setting[property]\">&nbsp; $setting[label]&nbsp;$setting[description]&nbsp;</label><hr>";
  }
  
  /* TEXTAREA */
  else if ($setting['fieldType'] === "textarea")
  { // if a long value is set
  $placeholder = $setting['placeholder'];
  // store placeholder from array in var to use it at language array
  if (isset($setting['longValue']) && (!empty($setting['longValue'])))
  { // build a longValue tagged textarea and fill with longValue
  $setting['longValue'] = nl2br($setting['longValue']);
  if (!empty($setting['icon']) || (!empty($setting['heading']) || (!empty($setting['subtext']))))
  {
  echo "<h4 class=\"box-title\">$setting[icon]&nbsp;$setting[heading]&nbsp;<small>$setting[subtext]</small></h4>";
  }
  echo "<label for=\"$setting[property]\">$setting[label]&nbsp;$setting[description]&nbsp;</label>
  <textarea style=\"margin-bottom:10px;\" cols=\"64\" rows=\"4\" class=\"$setting[fieldClass]\" placeholder=\"$lang[$placeholder]\" id=\"$setting[property]\" name=\"$setting[property]\">$setting[longValue]</textarea>";
  }
  else
  { // draw default textarea
  $setting['value'] = nl2br($setting['value']);
  if (!empty($setting['icon']) || (!empty($setting['heading']) || (!empty($setting['subtext']))))
  {
  echo "<br><h4 class=\"box-title\">$setting[icon]&nbsp;$setting[heading]&nbsp;<small>$setting[subtext]</small></h4>";
  }
  echo "<label for=\"$setting[property]-long\">$setting[label]&nbsp;$setting[description]&nbsp;</label>
  <textarea style=\"margin-bottom:10px;\" cols=\"64\" rows=\"4\" class=\"$setting[fieldClass]\" placeholder=\"$lang[$placeholder]\" id=\"$setting[property]\" name=\"$setting[property]\">$setting[value]</textarea>";
  }
  }
  
  /* INPUT PASSWORD FIELD */
  else if ($setting['fieldType'] === "password")
  { // draw an input field
  $placeholder = $setting['placeholder'];
  // store placeholder from array in var to use it at language array
  if (!empty($setting['icon']) || (!empty($setting['heading']) || (!empty($setting['subtext']))))
  {
  echo "<br><h4 class=\"box-title\">$setting[icon]&nbsp;$setting[heading]&nbsp;<small>$setting[subtext]</small></h4>";
  }
  echo "<label for=\"$setting[property]\">$setting[label]</label>&nbsp;$setting[description]&nbsp;
  <input style=\"margin-bottom:10px;\" type=\"password\" class=\"$setting[fieldClass]\" id=\"$setting[property]\" name=\"$setting[property]\" 
  value=\"$setting[value]\" placeholder=\"$lang[$placeholder]\">";
  }
  /* INPUT TEXT FIELD */
  else if ($setting['fieldType'] === "input")
  { // draw an input field
  $placeholder = $setting['placeholder'];
  // store placeholder from array in var to use it at language array
  if (!empty($setting['icon']) || (!empty($setting['heading']) || (!empty($setting['subtext']))))
  {
  echo "<br><h4 class=\"box-title\">$setting[icon]&nbsp;$setting[heading]&nbsp;<small>$setting[subtext]</small></h4>";
  }
  echo "<label for=\"$setting[property]\">$setting[label]&nbsp;$setting[description]&nbsp;
  <small><i class=\"small\" style=\"font-weight:normal\">$lang[DEFAULT]: $setting[valueDefault]</i></small></label>
  <input style=\"margin-bottom:10px;\" type=\"text\" class=\"$setting[fieldClass]\" id=\"$setting[property]\" name=\"$setting[property]\" 
  value=\"$setting[value]\" placeholder=\"$lang[$placeholder]\">";
  }
  
  /* COLOR TEXT FIELD */
  else if ($setting['fieldType'] === "color")
  { // draw a color input field
  $placeholder = $setting['placeholder']; // store placeholder from array in var to use it at language array
  if (!empty($setting['icon']) || (!empty($setting['heading']) || (!empty($setting['subtext']))))
  {
  echo "<br><h4 class=\"box-title\">$setting[icon]&nbsp;$setting[heading]&nbsp;<small>$setting[subtext]</small></h4>";
  }
  echo "<label for=\"$setting[property]\">$setting[label]&nbsp;$setting[description]&nbsp;
  <small><i class=\"small\" style=\"font-weight:normal\">$lang[DEFAULT]: $setting[valueDefault]</i></small></label>
  <input style=\"margin-bottom:10px;\" type=\"text\" class=\"$setting[fieldClass]\" id=\"$setting[property]\" name=\"$setting[property]\" 
  value=\"$setting[value]\" placeholder=\"$lang[$placeholder]\">";
  }
  
  /* TEMPLATE SELECT FIELD */
  else if ($setting['fieldType'] === "select template")
  { // display icon, heading and subtext, if its set
  
  $templateArray = \YAWK\template::getTemplateIds($db);
  if (!empty($setting['icon']) || (!empty($setting['heading']) || (!empty($setting['subtext']))))
  {
  echo "<br><h4 class=\"box-title\">$setting[icon]&nbsp;$setting[heading]&nbsp;<small>$setting[subtext]</small></h4>";
  }
  // begin draw select
  echo "<label for=\"$setting[property]\">$setting[label]&nbsp;$setting[description]&nbsp;
  <small><i class=\"small\" style=\"font-weight:normal\">$lang[DEFAULT]: $setting[valueDefault]</i></small></label>
  <select style=\"margin-bottom:10px;\" class=\"form-control\" id=\"$setting[property]\" name=\"$setting[property]\">";
  $activeTemplateName = \YAWK\template::getTemplateNameById($db, (int)$setting['value']);
  echo "<option value=\"$setting[value]\">$lang[SETTING_CURRENT] $activeTemplateName</option>";
  // explode option string into array
  $optionValues = explode(":", $setting['options']);
  foreach ($templateArray as $template)
  {
  if ($setting['value'] != $template['id']) {
  echo "<option value=\"".$template['id']."\"".$markup.">".$template['name']."</option>";
  }
  }
  echo "</select>";
  }
  else
  {
  // draw an input field
  $placeholder = $setting['placeholder'];
  // store placeholder from array in var to use it at language array
  if (!empty($setting['icon']) || (!empty($setting['heading']) || (!empty($setting['subtext']))))
  {
  echo "<br><h4 class=\"box-title\">$setting[icon]&nbsp;$setting[heading]&nbsp;<small>$setting[subtext]</small></h4>";
  }
  if (!isset($lang[$placeholder]) ||(empty($lang[$placeholder]))){ $phMarkup = ""; } else { $phMarkup = " placeholder=\"$lang[$placeholder]\""; }
  echo "<label for=\"$setting[property]\">$setting[label]&nbsp;$setting[description]&nbsp;
  <small><i class=\"small\" style=\"font-weight:normal\">$lang[DEFAULT]: $setting[valueDefault]</i></small></label>
  <input style=\"margin-bottom:10px;\" type=\"text\" class=\"$setting[fieldClass]\" id=\"$setting[property]\" name=\"$setting[property]\" 
  value=\"$setting[value]\"$phMarkup\">";
  }
  }
  }
  }
  }
  }

References $db, $lang, $settings, $type, $value, and YAWK\template\getTemplateIds().

◆ getGoogleFontsArray()

static YAWK\template::getGoogleFontsArray ( $db )

static

get all google fonts into an array and return array

Parameters

object $db database

Returns: array | null

Definition at line 1949 of file template.php.

  {
  // array that holds the data
  $googleFonts = array();
  // select google fonts from database
  if ($sql = $db->query("SELECT font FROM {gfonts} ORDER BY font")) { // for every single row...
  while ($row = mysqli_fetch_array($sql)) { // add font to array
  $googleFonts[] = $row['0'];
  }
  }
  // check if googleFont is set and an array and not empty
  if (isset($googleFonts) && (is_array($googleFonts) && (!empty($googleFonts)))) { // return array containing all google fonts
  return $googleFonts;
  } else { // no google font in database...
  return null;
  }
  }

References $db, $googleFonts, and $sql.

Referenced by YAWK\template\drawFontFamilySelectField().

◆ getMaxId()

static YAWK\template::getMaxId ( $db )

static

return biggest ID from template database

Parameters

object $db database

Returns: int|bool

Definition at line 779 of file template.php.

  {
  /* @param $db \YAWK\db */
  if ($res = $db->query("SELECT MAX(id) from {templates}")) { // fetch id
  if ($row = mysqli_fetch_row($res)) {
  return $row[0];
  } else {
  sys::setSyslog($db, 47, 1, "failed to get MAX(id) from template db", 0, 0, 0, 0);
  return false;
  }
  } else {
  return false;
  }
  }

References $db, and $res.

◆ getPositionDivBox()

static YAWK\template::getPositionDivBox	(	$db,
		$lang,
		$position,
		$row,
		$bootstrapGrid,
		$positions,
		$indicators,
		$user,
		$template
	)

static

return div box with postition settings

Parameters

object	$db	Database object
string	$position	The position to load
array	$positions	Positions [enabled] status array
array	$indicators	Positions [indicator] status array
object	$user	the current user object
object	$template	Template object

Definition at line 1118 of file template.php.

  {
  global $currentpage;
  if (isset($row) && (!empty($row))) {
  if ($row === "1") {
  $startRow = "<div class=\"row\">";
  $endRow = "</div>";
  } else {
  $startRow = '';
  $endRow = '';
  }
  } else {
  $startRow = '';
  $endRow = '';
  }
  
  // check if position indicator is enabled
  if ($positions["pos-$position-enabled"] === "1")
  { // check if position indicator is enabled
  if ($indicators["pos-$position-indicator"] === "1")
  { // display position indicator
  $indicatorStyle = "style=\"border: 1px solid red;\"";
  $indicatorText = "<i><b>$position</b></i>";
  }
  else
  { // no position indicator set
  $indicatorStyle = '';
  $indicatorText = '';
  }
  
  // output position div box
  echo "$startRow";
  echo "<div class=\"$bootstrapGrid pos-$position\" id=\"$position\" $indicatorStyle>$indicatorText";
  template::setPosition($db, $lang, "$position-pos", $currentpage, $user, $template);
  echo "
  </div>";
  echo "$endRow";
  }
  }

References $db, $indicators, $lang, YAWK\template\$positions, and YAWK\template\setPosition().

◆ getPositionIndicatorStatusArray()

static YAWK\template::getPositionIndicatorStatusArray	(	$db,
		$templateID
	)

static

get the position indicators. This is used on index.php to mark indicated positions

Parameters

object	$db	database
int	$templateID	ID of the current template

Returns: array|bool $array position indicator 0|1

Definition at line 2710 of file template.php.

  {
  $markedPositions = array();
  $sql = $db->query("SELECT property, value 
  FROM {template_settings} 
  WHERE property 
  LIKE 'pos-%-indicator'
  AND templateID = '" . $templateID . "'");
  while ($row = mysqli_fetch_assoc($sql)) {
  $prop = $row['property'];
  $markedPositions[$prop] = $row['value'];
  }
  if (!empty($markedPositions)) {
  return $markedPositions;
  } else {
  return false;
  }
  }

References $db, $sql, and $templateID.

◆ getPositionStatesArray()

static YAWK\template::getPositionStatesArray	(	$db,
		$templateID
	)

static

get the position states of all templates. This is used on index.php to render only templates that are enabled (1)

Parameters

object	$db	database
int	$templateID	ID of the current selected template

Returns: array|bool $array template positions 0|1

Definition at line 2686 of file template.php.

  {
  $array = array();
  $sql = $db->query("SELECT property, value 
  FROM {template_settings} 
  WHERE property LIKE 'pos-%-enabled' AND 
  templateID = '" . $templateID . "'");
  while ($row = mysqli_fetch_assoc($sql)) {
  $prop = $row['property'];
  $array[$prop] = $row['value'];
  }
  if (is_array($array) && (!empty($array))) {
  return $array;
  } else {
  die("Positions array not set");
  }
  }

References $db, $sql, $templateID, and die.

◆ getTemplateIds()

static YAWK\template::getTemplateIds ( object $db )

static

return array with all template id's + names.

Parameters

object $db database

Returns: array|bool

Parameters

\YAWK\db $db

Definition at line 426 of file template.php.

  {
  /** @param \YAWK\db $db */
  // returns an array with all template IDs
  $mysqlRes = $db->query("SELECT id, name
  FROM {templates}
  ORDER by name ASC");
  while ($row = mysqli_fetch_assoc($mysqlRes)) {
  $res[] = $row;
  }
  if (!empty($res)) { // yey, return array
  return $res;
  } else { // could not fetch array
  sys::setSyslog($db, 47, 1, "failed get template id and name ", 0, 0, 0, 0);
  return false;
  }
  }

References $db, and $res.

Referenced by YAWK\backend\drawTemplateSelectField(), and YAWK\template\getFormElements().

◆ getTemplateSettingsArray()

static YAWK\template::getTemplateSettingsArray	(	$db,
		$templateID
	)

static

get all template settings into an array and return it

Parameters

object	$db	database
int	$templateID	affected template ID

Returns: array

Definition at line 2794 of file template.php.

  {
  /* @var \YAWK\db $db */
  if (!isset($templateID) || (empty($templateID))) { // if no templateID is set, take current template ID from settings db
  $templateID = settings::getSetting($db, "selectedTemplate");
  }
  $array = array();
  $res = $db->query("SELECT property, value, longValue
  FROM {template_settings}
  WHERE templateID = $templateID");
  
  while ($row = mysqli_fetch_assoc($res)) {
  $prop = $row['property'];
  $array[$prop] = $row['value'];
  $array[$prop] .= $row['longValue'];
  }
  return $array;
  }

References $db, $res, $templateID, and YAWK\settings\getSetting().

◆ getValidTemplateID()

static YAWK\template::getValidTemplateID	(	$db,
		$user,
		$template
	)

static

check the current template ID, considering if user is logged in, allowed to override template and so on

Parameters

object	$db	database
object	$user	the current user object
object	$template	the current page object

Returns: int

Definition at line 2603 of file template.php.

  {
  // it is important to do some checks to determine the correct template id
  // to do that, we need data from 2 objects;
  
  // check if template and user obj are there and not empty
  if (isset($user) && (isset($template)))
  { // check, if user is allowed to override template
  
  if ($user->overrideTemplate == 1)
  { // ok, get user templateID
  if (!empty($user->templateID))
  { // set templateID for following query
  $validTemplateID = $user->templateID;
  }
  else
  { // user->TemplateID not set, instead use default template
  if (!empty($template->selectedTemplate))
  { // set global defined (current active), default template ID
  $validTemplateID = $template->selectedTemplate;
  }
  }
  }
  else
  { // user is not allowed to override template, use default template
  if (!empty($template->selectedTemplate))
  { // set global defined (current active), default template ID
  $validTemplateID = $template->selectedTemplate;
  }
  }
  }
  else
  { // unable to determine template from objects, load active (global) template instead
  $validTemplateID = settings::getSetting($db, "selectedTemplate");
  }
  // for any reasons, that valid template ID could not be set
  if (!isset($validTemplateID) || (empty($validTemplateID)))
  { // set current (active / selected) template as templateID
  $validTemplateID = settings::getSetting($db, "selectedTemplate");
  }
  // must be set
  return $validTemplateID;
  }

References $db, and YAWK\settings\getSetting().

Referenced by YAWK\template\getCurrentTemplateId().

◆ includeHeader()

static YAWK\template::includeHeader ( $db )

static

include header for html page *outdated? *moved to sys?

Parameters

object $db database

Parameters

\YAWK\db $db

Definition at line 2651 of file template.php.

  {
  /** @param \YAWK\db $db */
  global $currentpage;
  $i = 1;
  $host = settings::getSetting($db, "host");
  echo "<title>" . $currentpage->title . "</title>
  <meta http-equiv=\"Content-Type\" content=\"text/html; charset=\"utf-8\">
  <link rel=\"shortcut icon\" href=\"favicon.ico\" type=\"image/x-icon\">
  <base href=\"" . $host . "/\">";
  $get_localtags = $db->query("SELECT name, content
  FROM {meta_local}
  WHERE page = '" . $currentpage->id . "'");
  while ($row = mysqli_fetch_row($get_localtags)) {
  if (isset($row['1']) && !empty($row['1'])) {
  echo "<meta name=\"" . $row[0] . "\" content=\"" . $row[1] . "\" />";
  } else {
  $get_globaltags = $db->query("SELECT content
  FROM {meta_global}
  WHERE name = 'description'");
  $row = mysqli_fetch_row($get_globaltags);
  while ($i > 0) {
  echo "<meta name=\"description\" content=\"" . $row[0] . "\" />";
  $i--;
  }
  }
  }
  }

References $db, $host, $i, and YAWK\settings\getSetting().

◆ loadActiveAssets()

YAWK\template::loadActiveAssets	(	$db,
		$templateID,
		$host
	)

Load Active Assets.

Load HTML markup for each active asset of current template

Parameters

$db	object db connection
$templateID	int the current template ID
$host	string host URL will be used by internal assets to avoid relative paths
$type	string css\|js to detect which assets to load

Returns: null

Definition at line 3045 of file template.php.

  {
  /* @var \YAWK\db $db */
  
  // check if templateID is set
  if (isset($templateID) && (!empty($templateID)))
  {
  echo "
 <!-- ASSETS -->";
  // get assets from database for this template
  if ($res = $db->query("SELECT type, asset, link FROM {assets} WHERE templateID = '" . $templateID . "' ORDER BY sortation ASC"))
  {
  // loop through assets
  while ($row = mysqli_fetch_assoc($res))
  {
  // make sure, host will only be added for relative url assets
  if (stristr($row['link'], 'http://') || (stristr($row['link'], 'https://')) === FALSE) {
  // echo "".$row['link']." internal:";
  $url = $host . $row['link'];
  // do nothing
  } else { // external URL, do not prepend host string to link
  // echo "".$row['link']." ext:";
  $url = $row['link'];
  }
  
  if ($row['type'] === "js")
  { // load js asset
  echo "
 <!--load JS: $row[asset] -->
 <script src = \"" . $url . "\"></script>";
  }
  else if ($row['type'] === "css")
  { // load css asset
  echo "
 <!-- load CSS: $row[asset] -->
 <link rel=\"stylesheet\" href=\"" . $url . "\" type=\"text/css\" media=\"all\">";
  }
  }
  }
  }
  return null;
  }

References $db, $host, $res, $templateID, and $url.

◆ loadActiveAssetsIntoArray()

YAWK\template::loadActiveAssetsIntoArray	(	$db,
		$templateID
	)

Definition at line 3088 of file template.php.

  {
  /* @var \YAWK\db $db */
  
  if (isset($templateID) && (!empty($templateID)))
  {
  if ($sql = $db->query("SELECT * FROM {assets} WHERE templateID = '" . $templateID . "'"))
  { // fetch data
  while ($row = mysqli_fetch_assoc($sql)) { // store data as array
  $assets[] = $row;
  }
  }
  if (isset($assets) && (is_array($assets) && (!empty($assets))))
  {
  return $assets;
  }
  else
  {
  return false;
  }
  }
  else
  { // template ID is not set
  return false;
  }
  }

References $db, $sql, and $templateID.

Referenced by YAWK\template\downloadTemplate().

◆ loadAllSettingsIntoArray()

YAWK\template::loadAllSettingsIntoArray	(	object	$db,
		int	$id
	)

load template settings of ID and return as array

Parameters

object	$db	database object
int	$id	template id to load

Returns: array|false

Parameters

$db	\YAWK\db $res

Definition at line 328 of file template.php.

  {
  /** @param $db \YAWK\db $res */
  $res = $db->query("SELECT * FROM {template_settings} WHERE templateID = '" . $id . "'");
  while ($row = mysqli_fetch_assoc($res))
  {
  $templateSettings[] = $row;
  }
  
  if (isset($templateSettings) && (is_array($templateSettings) && (!empty($templateSettings))))
  { // not an array or empty...
  return $templateSettings;
  }
  else
  { // could not fetch tpl properties, throw error...
  sys::setSyslog($db, 47, 1, "failed to load template_settings of template id <b>$id</b> into array", 0, 0, 0, 0);
  return false;
  }
  }

References $db, YAWK\template\$id, $res, and $templateSettings.

Referenced by YAWK\template\downloadTemplate().

◆ loadGoogleFonts()

static YAWK\template::loadGoogleFonts ( $db )

static

get settings for heading, menu and text font and output html to load font

Parameters

object $db database

Definition at line 2536 of file template.php.

  {
  $fonts = array(); // hold all fonts
  $googleFontFamilyString = ''; // the string the contains all google font families to minimize requests
  if ($sql = $db->query("SELECT value FROM {template_settings} WHERE property LIKE '%-fontfamily'")) {
  while ($row = mysqli_fetch_row($sql)) {
  $fonts[] = $row[0];
  }
  }
  foreach ($fonts as $googleFont) {
  if (substr($googleFont, -6) === "-gfont") {
  // remove font indicator
  $googleFont = rtrim($googleFont, "gfont");
  $googleFont = rtrim($googleFont, "-");
  // build google font loading string
  $googleFontFamilyString .= $googleFont;
  // add | to allow loading more than one font
  $googleFontFamilyString .= "|";
  }
  }
  if (!empty($googleFontFamilyString)) {
  // remove last | because its not needed
  $googleFontFamilyString = rtrim($googleFontFamilyString, "|");
  echo "<link rel=\"dns-prefetch\" href=\"//fonts.googleapis.com\">";
  echo "<link href=\"https://fonts.googleapis.com/css?family=$googleFontFamilyString\" rel=\"stylesheet\">";
  }
  
  }

References $db, and $sql.

◆ loadProperties()

YAWK\template::loadProperties	(	$db,
		$id
	)

load properties into template object

Parameters

object	$db	database object
int	$id	template id to load

Returns: bool true or false

Parameters

$db	\YAWK\db $res

Definition at line 264 of file template.php.

  {
  /** @param $db \YAWK\db $res */
  $res = $db->query("SELECT * FROM {templates} WHERE id = '" . $id . "'");
  if ($row = mysqli_fetch_assoc($res)) {
  $this->id = $row['id'];
  $this->active = $row['active'];
  $this->name = $row['name'];
  $this->positions = $row['positions'];
  $this->description = $row['description'];
  $this->releaseDate = $row['releaseDate'];
  $this->author = $row['author'];
  $this->authorUrl = $row['authorUrl'];
  $this->weblink = $row['weblink'];
  $this->subAuthor = $row['subAuthor'];
  $this->subAuthorUrl = $row['subAuthorUrl'];
  $this->modifyDate = $row['modifyDate'];
  $this->version = $row['version'];
  $this->framework = $row['framework'];
  $this->license = $row['license'];
  $this->selectedTemplate = settings::getSetting($db, "selectedTemplate");
  return true;
  } else { // could not fetch tpl properties, throw error...
  sys::setSyslog($db, 47, 1, "failed to load properties of template <b>$this->name</b> (id: <b>$id</b>)", 0, 0, 0, 0);
  // \YAWK\alert::draw("danger", "Warning!", "Could not fetch template properties. Expect a buggy view.", "", 3000);
  return false;
  }
  }

References $db, YAWK\template\$id, $res, description, YAWK\settings\getSetting(), name, and selectedTemplate.

Referenced by YAWK\template\downloadTemplate().

◆ loadPropertiesIntoArray()

YAWK\template::loadPropertiesIntoArray	(	object	$db,
		int	$id
	)

load template properties and return as array

Parameters

object	$db	database object
int	$id	template id to load

Returns: bool|array true or false

Parameters

$db	\YAWK\db $res

Definition at line 300 of file template.php.

  {
  /** @param $db \YAWK\db $res */
  $res = $db->query("SELECT * FROM {templates} WHERE id = '" . $id . "'");
  if ($row = mysqli_fetch_assoc($res))
  {
  if (!is_array($row) || (empty($row)))
  { // not an array or empty...
  return false;
  }
  else
  { // return array
  return $row;
  }
  }
  else
  { // could not fetch tpl properties, throw error...
  sys::setSyslog($db, 47, 1, "failed to load properties of template id <b>$id</b> into array", 0, 0, 0, 0);
  return false;
  }
  }

References $db, YAWK\template\$id, and $res.

Referenced by YAWK\template\downloadTemplate().

◆ loadSettingsTypesIntoArray()

YAWK\template::loadSettingsTypesIntoArray ( object $db )

load template_settings_types and return as array

Parameters

object $db database object

Returns: array|false

Parameters

$db	\YAWK\db $res

Definition at line 401 of file template.php.

  {
  /** @param $db \YAWK\db $res */
  $res = $db->query("SELECT * FROM {template_settings_types}");
  while ($row = mysqli_fetch_assoc($res))
  {
  $settingsTypes[] = $row;
  }
  if (isset($settingsTypes) && (is_array($settingsTypes) && (!empty($settingsTypes))))
  { // all good,
  return $settingsTypes;
  }
  else
  { // could not fetch tpl properties, throw error...
  sys::setSyslog($db, 47, 1, "failed to load template_settings_types into array", 0, 0, 0, 0);
  return false;
  }
  }

References $db, and $res.

Referenced by YAWK\template\downloadTemplate().

◆ returnCurrentBootstrapVersion()

static YAWK\template::returnCurrentBootstrapVersion	(	$db,
		$templateID
	)

static

Return which Bootstrap version is currently loaded in given template.

Parameters

object $db database

Returns: string Which Bootstrap v is setup in given template ID

Definition at line 3158 of file template.php.

  {
  // query database
  if ($sql = $db->query("SELECT asset FROM {assets} WHERE templateID = '" . $templateID . "' AND asset LIKE '%Bootstrap%CSS'")) { // fetch data
  while ($row = mysqli_fetch_row($sql)) { // store data as array
  $asset[] = $row;
  }
  }
  
  // check if asset array is set and not empty
  if (isset($asset) && (is_array($asset) && (!empty($asset[0][0]))))
  {
  if ($asset[0][0] === "Bootstrap 4 CSS")
  { // v4
  return "4";
  }
  
  else if ($asset[0][0] === "Bootstrap 3 CSS")
  { // v3
  return "3";
  }
  else
  { // unable to detect bootstrap version, maybe this template ID does not load bootstrap
  return "0";
  }
  }
  return null;
  }

References $db, $sql, and $templateID.

Referenced by YAWK\menu\display().

◆ saveAs()

YAWK\template::saveAs ( object $db )

save a template as new. It copies the tpl folder and all settings into a new one.

Parameters

object	$db
object	$template
string	$new_template
string	$description
string	$author
string	$authorUrl
string	$weblink
string	$version
string	$license

Returns: bool

Parameters

\YAWK\db $db

Definition at line 201 of file template.php.

  : bool
  {
  /** @param \YAWK\db $db */
  // prepare vars
  $replace = array("/ä/", "/ü/", "/ö/", "/Ä/", "/Ü/", "/Ö/", "/ß/"); // array of special chars
  $chars = array("ae", "ue", "oe", "Ae", "Ue", "Oe", "ss"); // array of replacement chars
  $this->newTplName = preg_replace($replace, $chars, $this->newTplName); // replace with preg
  // final check: just numbers and chars are allowed
  $this->newTplName = preg_replace("/[^a-z0-9\-\/]/i", "", $this->newTplName);
  // same goes on for $template->name
  $this->name = preg_replace($replace, $chars, $this->name); // replace with preg
  // final check: just numbers and chars are allowed
  $this->name = preg_replace("/[^a-z0-9\-\/]/i", "", $this->name);
  // get current timestamp
  $now = sys::now();
  
  // copy new template into database
  if ($res = $db->query("INSERT INTO {templates} (name, positions, description, releaseDate, author, authorUrl, weblink, subAuthor, subAuthorUrl, modifyDate, version, framework, license)
  VALUES('" . $this->newTplName . "', 
  '" . $this->positions . "',
  '" . $this->description . "',
  '" . $now . "',
  '" . $this->author . "',
  '" . $this->authorUrl . "',
  '" . $this->weblink . "',
  '" . $this->subAuthor ."',
  '" . $this->subAuthorUrl ."',
  '" . $now . "',
  '" . $this->version . "',
  '" . $this->framework . "',
  '" . $this->license . "')"))
  {
  
  }
  else
  { // q failed, throw error
  sys::setSyslog($db, 47, 1, "failed to save <b>$this->newTplName</b> as new template", 0, 0, 0, 0);
  // \YAWK\alert::draw("warning", "Warning!", "Could not insert your template $new_template into database.", "", 6200);
  return false;
  }
  // tpl added to database successful
  // check if template folder exists
  if (is_dir(dirname("../system/templates/$this->name")))
  {
  // ok, start to copy template from source to new destination
  sys::xcopy("../system/templates/$this->name", "../system/templates/$this->newTplName");
  sys::setSyslog($db, 47, 1, "copy template folder from ../system/templates/$this->name to ../system/templates/$this->newTplName", 0, 0, 0, 0);
  return true;
  }
  else
  { // template folder does not exist
  // what should we copy if nothing exists?
  sys::setSyslog($db, 47, 1, "failed to copy template - template name $this->name does not exist", 0, 0, 0, 0);
  return false;
  }
  }

References $db, $now, $res, name, YAWK\sys\now(), and YAWK\sys\xcopy().

◆ saveProperties()

YAWK\template::saveProperties	(	object	$db,
		int	$id,
		array	$data,
		array	$oldTplSettings
	)

save new template properties into database

Parameters

object	$db	database object
int	$id	template id to save
array	$data	post data from form (new settings)
array	$oldTplSettings	template settings array (old settings)

Returns: bool true or false

Definition at line 356 of file template.php.

  : bool
  {
  // check if data is set set
  if (!isset($data) || (!isset($id))) { // if not, abort
  return false;
  }
  if (empty($oldTplSettings))
  {
  $oldTplSettings = array();
  }
  
  // walk through all post data settings
  foreach ($data as $property => $value)
  {
  // check, if settings is a long value
  if (fnmatch('*-longValue', $property))
  { // it is, set long value indicator to true
  $longValue = 1;
  }
  else
  { // not a long value
  $longValue = 0;
  }
  
  // save this property only if its NOT save or customcss
  if ($property != "save" && ($property != "customCSS") && ($property != "testText")) {
  if (isset($oldTplSettings[$property]) && ($oldTplSettings[$property]) === $value)
  { // if old settings and new settings are the same
  // do nothing
  }
  else
  { // update template setting
  $this->setTemplateSetting($db, $id, $property, $value, $longValue);
  }
  }
  }
  return true;
  }

References $data, $db, YAWK\template\$id, $oldTplSettings, and $value.

◆ setCssBodyFontFace()

static YAWK\template::setCssBodyFontFace	(	$cssTagName,
		$tplSettings
	)

static

set css code for custom fonts (ttf / otf / woff)

Parameters

$cssTagName
$tplSettings

Returns: string

Definition at line 2127 of file template.php.

  {
  $bodyFontFaceCSS = '';
  $fontFamily = $tplSettings["$cssTagName-fontfamily"];
  // get font type by cutting off file extension
  $fontType = substr($fontFamily, -4);
  // check file types
  if ($fontType === "-ttf") {
  $filename = str_replace("-ttf", ".ttf", $fontFamily);
  $bodyFontFaceCSS = "@font-face {
  font-family: $fontFamily;
  src: url('../../../fonts/$filename');
  }";
  } elseif ($fontType === "-otf") {
  $filename = str_replace("-otf", ".otf", $fontFamily);
  $bodyFontFaceCSS = "@font-face {
  font-family: $fontFamily;
  src: url('../../../fonts/$filename');
  }";
  } elseif ($fontType === "woff") {
  $filename = str_replace("-woff", ".woff", $fontFamily);
  $bodyFontFaceCSS = "@font-face {
  font-family: $fontFamily;
  src: url('../../../fonts/$filename') !important;
  }";
  }
  return $bodyFontFaceCSS;
  }

References $filename.

◆ setCssBodyFontSettings()

static YAWK\template::setCssBodyFontSettings	(	$cssTagName,
		$tplSettings
	)

static

set body font settings css code

Parameters

$cssTagName
$tplSettings

Returns: string

Definition at line 2220 of file template.php.

  {
  $fontFamily = $tplSettings["$cssTagName-fontfamily"];
  $fontSize = $tplSettings["$cssTagName-size"];
  $fontColor = $tplSettings["$cssTagName-fontcolor"];
  $fontShadowSize = $tplSettings["$cssTagName-fontshadowsize"];
  $fontShadowColor = $tplSettings["$cssTagName-fontshadowcolor"];
  $fontWeight = $tplSettings["$cssTagName-fontweight"];
  $fontStyle = $tplSettings["$cssTagName-fontstyle"];
  $fontTextDecoration = $tplSettings["$cssTagName-textdecoration"];
  // check, if it's a google font
  if (substr($fontFamily, -6) === "-gfont") {
  $googleFont = substr($fontFamily, 0, -6);
  $bodyFontCSS = "
  font-family: $googleFont !important;
  font-size: $fontSize;
  color: #$fontColor;
  text-shadow: $fontShadowSize #$fontShadowColor;
  font-weight: $fontWeight;
  font-style: $fontStyle;
  text-decoration: $fontTextDecoration;
  ";
  } else {
  $bodyFontCSS = "
  font-family: $fontFamily;
  font-size: $fontSize;
  color: #$fontColor;
  text-shadow: $fontShadowSize #$fontShadowColor;
  font-weight: $fontWeight;
  font-style: $fontStyle;
  text-decoration: $fontTextDecoration;
  ";
  }
  return $bodyFontCSS;
  }

◆ setCssBodyLinkTags()

static YAWK\template::setCssBodyLinkTags	(	$cssTagName,
		$tplSettings
	)

static

set css code for body link styling

Parameters

$cssTagName
$tplSettings

Returns: string

Definition at line 2162 of file template.php.

  {
  $aLink = $tplSettings["$cssTagName-alink"];
  $aVisited = $tplSettings["$cssTagName-avisited"];
  $aHover = $tplSettings["$cssTagName-ahover"];
  $aWeight = $tplSettings["$cssTagName-linkfontweight"];
  $aStyle = $tplSettings["$cssTagName-linkfontstyle"];
  $aDecoration = $tplSettings["$cssTagName-linktextdecoration"];
  $hoverDecoration = $tplSettings["$cssTagName-hovertextdecoration"];
  $bodyLinkTags = "
  /* TODO: must be out of body */ 
  a:link { 
  color: #$aLink;
  font-weight: $aWeight;
  font-style: $aStyle;
  text-decoration: $aDecoration;
  }
  a:visited {
  color: #$aVisited;
  }
  a:hover { 
  color: #$aHover;
  text-decoration: $hoverDecoration;
  }
  ";
  return $bodyLinkTags;
  }

◆ setCssBodySmallFontSettings()

static YAWK\template::setCssBodySmallFontSettings	(	$cssTagName,
		$tplSettings
	)

static

set small font settings css code

Parameters

$cssTagName
$tplSettings

Returns: string

Definition at line 2196 of file template.php.

  {
  $smallColor = $tplSettings["$cssTagName-smallcolor"];
  $smallShadowSize = $tplSettings["$cssTagName-smallshadowsize"];
  $smallShadowColor = $tplSettings["$cssTagName-smallshadowcolor"];
  
  $bodySmallTags = "small,
  .small
  {
  font-weight: normal;
  line-height: 1;
  color: #$smallColor;
  text-shadow: $smallShadowSize #$smallShadowColor;
  }
  ";
  return $bodySmallTags;
  }

◆ setCssFontSettings()

static YAWK\template::setCssFontSettings	(	$cssTagName,
		$tplSettings
	)

static

set font settings css code

Parameters

$cssTagName
$tplSettings

Returns: string

Definition at line 2262 of file template.php.

  {
  $fontFamily = $tplSettings["$cssTagName-fontfamily"];
  $fontSize = $tplSettings["$cssTagName-size"];
  $fontColor = $tplSettings["$cssTagName-fontcolor"];
  $fontShadowSize = $tplSettings["$cssTagName-fontshadowsize"];
  $fontShadowColor = $tplSettings["$cssTagName-fontshadowcolor"];
  $fontWeight = $tplSettings["$cssTagName-fontweight"];
  $fontStyle = $tplSettings["$cssTagName-fontstyle"];
  $fontTextDecoration = $tplSettings["$cssTagName-textdecoration"];
  $aLink = $tplSettings["$cssTagName-alink"];
  $aVisited = $tplSettings["$cssTagName-avisited"];
  $aHover = $tplSettings["$cssTagName-ahover"];
  $aWeight = $tplSettings["$cssTagName-linkfontweight"];
  $aStyle = $tplSettings["$cssTagName-linkfontstyle"];
  $aDecoration = $tplSettings["$cssTagName-linktextdecoration"];
  $hoverDecoration = $tplSettings["$cssTagName-hovertextdecoration"];
  $smallColor = $tplSettings["$cssTagName-smallcolor"];
  $smallShadowSize = $tplSettings["$cssTagName-smallshadowsize"];
  $smallShadowColor = $tplSettings["$cssTagName-smallshadowcolor"];
  
  // get font type by cutting off file extension
  $fontType = substr($fontFamily, -4);
  // check file types
  if ($fontType === "-ttf") {
  $filename = str_replace("-ttf", ".ttf", $fontFamily);
  $fontCSS = "@font-face {
  font-family: $fontFamily;
  src: url('../../../fonts/$filename');
  }
  $cssTagName 
  {
  font-family: $fontFamily !important;
  font-size: $fontSize;
  color: #$fontColor;
  text-shadow: $fontShadowSize #$fontShadowColor;
  font-weight: $fontWeight;
  font-style: $fontStyle;
  text-decoration: $fontTextDecoration;
  }
  $cssTagName a:link { /* LINK SETTINGS */
  color: #$aLink;
  font-weight: $aWeight;
  font-style: $aStyle;
  text-decoration: $aDecoration;
  }
  $cssTagName a:visited {
  color: #$aVisited;
  }
  $cssTagName a:hover { 
  color: #$aHover;
  text-decoration: $hoverDecoration;
  }
  $cssTagName small,
  .$cssTagName small
  {
  font-weight: normal;
  line-height: 1;
  color: #$smallColor;
  text-shadow: $smallShadowSize #$smallShadowColor;
  }
  ";
  } elseif ($fontType === "-otf") {
  $filename = str_replace("-otf", ".otf", $fontFamily);
  $fontCSS = "@font-face {
  font-family: $fontFamily;
  src: url('../../../fonts/$filename');
  }
  $cssTagName 
  { 
  font-family: $fontFamily !important;
  font-size: $fontSize;
  color: #$fontColor;
  text-shadow: $fontShadowSize #$fontShadowColor;
  font-weight: $fontWeight;
  font-style: $fontStyle;
  text-decoration: $fontTextDecoration;
  }
  $cssTagName a:link { /* LINK SETTINGS */
  color: #$aLink;
  font-weight: $aWeight;
  font-style: $aStyle;
  text-decoration: $aDecoration;
  }
  $cssTagName a:visited {
  color: #$aVisited;
  }
  $cssTagName a:hover { 
  color: #$aHover;
  text-decoration: $hoverDecoration;
  }
  $cssTagName small,
  .$cssTagName small
  {
  font-weight: normal;
  line-height: 1;
  color: #$smallColor;
  text-shadow: $smallShadowSize #$smallShadowColor;
  }
  ";
  } elseif ($fontType === "woff") {
  $filename = str_replace("-woff", ".woff", $fontFamily);
  $fontCSS = "@font-face {
  font-family: $fontFamily;
  src: url('../../../fonts/$filename') !important;
  }
  $cssTagName 
  {
  font-family: $fontFamily !important;
  font-size: $fontSize;
  color: #$fontColor;
  text-shadow: $fontShadowSize #$fontShadowColor;
  font-weight: $fontWeight;
  font-style: $fontStyle;
  text-decoration: $fontTextDecoration;
  }
  $cssTagName a:link { /* LINK SETTINGS */
  color: #$aLink;
  font-weight: $aWeight;
  font-style: $aStyle;
  text-decoration: $aDecoration;
  }
  $cssTagName a:visited {
  color: #$aVisited;
  }
  $cssTagName a:hover { 
  color: #$aHover;
  text-decoration: $hoverDecoration;
  }
  $cssTagName small,
  .$cssTagName small
  {
  font-weight: normal;
  line-height: 1;
  color: #$smallColor;
  text-shadow: $smallShadowSize #$smallShadowColor;
  }
  ";
  } // check, if it's a google font
  elseif (substr($fontFamily, -6) === "-gfont") {
  $googleFont = substr($fontFamily, 0, -6);
  $fontCSS = "
  $cssTagName
  {
  font-family: $googleFont !important;
  font-size: $fontSize;
  color: #$fontColor;
  text-shadow: $fontShadowSize #$fontShadowColor;
  font-weight: $fontWeight;
  font-style: $fontStyle;
  text-decoration: $fontTextDecoration;
  }
  
  $cssTagName a:link { /* LINK SETTINGS */
  color: #$aLink;
  font-weight: $aWeight;
  font-style: $aStyle;
  text-decoration: $aDecoration;
  }
  $cssTagName a:visited {
  color: #$aVisited;
  }
  $cssTagName a:hover { 
  color: #$aHover;
  text-decoration: $hoverDecoration;
  }
  $cssTagName small,
  .$cssTagName small
  {
  font-weight: normal;
  line-height: 1;
  color: #$smallColor;
  text-shadow: $smallShadowSize #$smallShadowColor;
  }
  ";
  } else {
  $fontCSS = "
  $cssTagName 
  {
  font-family: $fontFamily;
  font-size: $fontSize;
  color: #$fontColor;
  text-shadow: $fontShadowSize #$fontShadowColor;
  font-weight: $fontWeight;
  font-style: $fontStyle;
  text-decoration: $fontTextDecoration;
  }
  
  $cssTagName a:link { /* LINK SETTINGS */
  color: #$aLink;
  font-weight: $aWeight;
  font-style: $aStyle;
  text-decoration: $aDecoration;
  }
  $cssTagName a:visited {
  color: #$aVisited;
  }
  $cssTagName a:hover { 
  color: #$aHover;
  text-decoration: $hoverDecoration;
  }
  $cssTagName small,
  .$cssTagName small
  {
  font-weight: normal;
  line-height: 1;
  color: #$smallColor;
  text-shadow: $smallShadowSize #$smallShadowColor;
  }
  ";
  }
  return $fontCSS;
  }

References $filename.

◆ setPosition()

static YAWK\template::setPosition	(	$db,
		$lang,
		$position,
		$currentpage,
		$user,
		$template
	)

static

set template position and output the correct data depending on position

Parameters

object	$db	database
object	$user	the current user object
string	$position	the template position
object	$template	template object

Definition at line 2736 of file template.php.

  {
  $main_set = 0;
  $globalmenu_set = 0;
  // get template setting for given pos
  // $setting = self::getTemplateSetting($db, $position, "");
  if (empty($setting)) {
  // no property
  // substr, because css definitions are without -pos (changefix?!)
  $position = substr("$position", 0, -4);
  // if main, we need to include the content page
  if ($position == "main") {
  // if user is given to index.php, load userpage
  if (isset($_GET['user'])) {
  // if var is set, but empty, show all users
  if (empty($_GET['user'])) {
  echo "<h2>Show all users</h2>";
  user::getUserList($db);
  } else {
  // show userpage
  echo "<h2>Show Profile of user $_GET[user]</h2>";
  }
  } // if a blog is requested, load blog by given id
  elseif (isset($_GET['blogid'])) {
  $blog = new \YAWK\PLUGINS\BLOG\blog();
  $blog->limitEntries = $blog->getBlogProperty($db, $_GET['blogid'], "limitEntries");
  $blog->getFrontendEntries($db, $_GET['blogid'], '', '', $blog->limitEntries);
  $blog->getFooter($db);
  $blog->draw();
  // in any other case, get content for requested static page
  } else {
  echo "<div id=\"$position\">";
  $currentpage->getContent($db, $lang);
  echo "</div>";
  $main_set = 1;
  }
  }
  
  // if position is globalmenu
  if ($position == "globalmenu") {
  \YAWK\menu::displayGlobalMenu($db, $user, $template);
  $globalmenu_set = 1;
  }
  // in any other case, simply load a div box onto given position
  if (!$globalmenu_set == 1) {
  echo "<div id=\"$position\">";
  echo \YAWK\widget::loadWidgets($db, $position);
  echo "</div>";
  }
  }
  }

References $_GET, $blog, $db, $lang, $position, YAWK\menu\displayGlobalMenu(), and YAWK\user\getUserList().

Referenced by YAWK\template\getPositionDivBox().

◆ switchPositionIndicators()

YAWK\template::switchPositionIndicators	(	object	$db,
		int	$templateID,
		int	$status
	)

switch all positions indicators on or off

Parameters

int	$templateID	ID of the affected template
int	$status	value to set (0\|1)
object	$db

Returns: bool true|false

Definition at line 131 of file template.php.

  : bool
  {
  // if template param is not set
  if (!isset($templateID) || (!is_numeric($templateID))) { // get current active template ID
  $templateID = self::getCurrentTemplateId($db);
  }
  
  // if status parameter is not set
  if (!isset($status) || (!is_numeric($status))) { // turn off is default behaviour
  $status = 0;
  }
  
  // update position indicator status
  if ($db->query("UPDATE {template_settings} 
  SET value = '" . $status . "'
  WHERE property 
  LIKE '%indicator%'
  AND templateID = '" . $templateID . "'")
  ) { // all good,
  return true;
  } else { // update position indicators failed
  return false;
  }
  }

References $db, $templateID, and YAWK\template\getCurrentTemplateId().

◆ uploadTemplate()

YAWK\template::uploadTemplate	(	$db,
		$postData,
		$postFiles,
		$lang
	)

Upload a template (install / update)

Parameters

object	$db	database object
array	$postData	data that has been sent by upload form
array	$postFiles	uploaded file that has been sent by upload form

Returns: bool true|false

upload .zip file, unpack to tmp folder,

Definition at line 3268 of file template.php.

  {
  // check if params are set and valid...
  if (!isset($postData)
  || (empty($postData)
  || (!is_array($postData))))
  { // post data wrong
  return false;
  }
  if (!isset($postFiles['templateFile'])
  || (empty($postFiles['templateFile'])
  || (!is_array($postFiles['templateFile']))))
  { // post file data wrong
  return false;
  }
  
  // prepare (empty) temp directory
  $this->emptyTmpFolder();
  
  // check if tmp folder exists...
  if (!is_dir(dirname($this->tmpFolder)))
  {
  // try to create tmp folder
  if (!mkdir($this->tmpFolder))
  {
  // add syslog: failed to create $this->tmpFolder
  return false;
  }
  }
  
  // check if template folder is writeable
  if (is_writeable(dirname($this->folder)))
  {
  // check if tmp folder exits
  if (is_dir(dirname($this->tmpFolder)))
  {
  $this->uploadFile = $this->tmpFolder.$postFiles['templateFile']['name'];
  
  // check for errors
  if ($postFiles['templateFile']['error'] !== 0)
  { // unknown error - upload failed
  sys::setSyslog($db, 48, 2, "failed to upload file - unknown error (".$postFiles['templateFile']['error'].") processing file ".$postFiles['templateFile']['name']."", 0, 0, 0, 0);
  // echo \YAWK\alert::draw("warning", $lang['ERROR'], $lang['FILE_UPLOAD_FAILED'], "", 4800);
  }
  else
  { // try to move uploaded file
  if (!move_uploaded_file($postFiles['templateFile']['tmp_name'], $this->uploadFile))
  { // throw error msg
  sys::setSyslog($db, 48, 2, "failed to move upload file $this->uploadFile to folder ".$postFiles['templateFile']['tmp_name']."", 0, 0, 0, 0);
  // echo \YAWK\alert::draw("danger", "$lang[ERROR]", "$this->uploadFile - $lang[FILE_UPLOAD_ERROR]","","4800");
  }
  else
  { // file upload seem to be successful...
  // check if uploaded file is there
  if (is_file($this->uploadFile))
  {
  // here we could check more things - eg latest file timestamp
  // create zip object + extract to tmp folder
  $zip = new \ZipArchive;
  // open zip archive
  $res = $zip->open($this->uploadFile);
  // if zip open was successful
  if ($res === TRUE)
  { // extract zip file
  $zip->extractTo($this->tmpFolder);
  // close zip file
  $zip->close();
  }
  
  // check and read template.ini file - stores all information about the template
  if (is_file($this->tmpFolder.'template.ini'))
  {
  // try to parse ini file into array
  if (!$iniFile = parse_ini_file($this->tmpFolder."template.ini"))
  { // error: unable to parse ini file
  sys::setSyslog($db, 48, 2, "failed to parse ini file ".$this->tmpFolder."template.ini ", 0, 0, 0, 0);
  return false;
  }
  }
  else
  { // error: ini file not there
  sys::setSyslog($db, 48, 2, "failed to parse ini file ".$this->tmpFolder."template.ini - file not found", 0, 0, 0, 0);
  return false;
  }
  
  // set target path
  $this->targetPath = $iniFile['TARGET_PATH'];
  // set subfolder
  $this->subFolder = $iniFile['SUBFOLDER']."/";
  
  // read assets.json into array
  if (is_file($this->tmpFolder.$this->subFolder.'assets.json'))
  { // read and decode json file into array
  $assets = json_decode(file_get_contents($this->tmpFolder.$this->subFolder.'assets.json'), true);
  }
  else
  { // assets.json not found
  $assets = '';
  sys::setSyslog($db, 48, 1, "failed to get ".$this->tmpFolder.$this->subFolder."assets.json - file not found", 0, 0, 0, 0);
  }
  
  // read template settings into array
  if (is_file($this->tmpFolder.$this->subFolder.'template_settings.json'))
  { // read and decode json file into array
  $templateSettings = json_decode(file_get_contents($this->tmpFolder.$this->subFolder.'template_settings.json'), true);
  }
  else
  { // template_settings.json not found
  $templateSettings = '';
  sys::setSyslog($db, 48, 1, "failed to get ".$this->tmpFolder.$this->subFolder."template_settings.json - file not found", 0, 0, 0, 0);
  }
  
  // read template_settings_types into array
  if (is_file($this->tmpFolder.$this->subFolder.'template_settings_types.json'))
  { // read and decode json into array
  $templateSettingsTypes = json_decode(file_get_contents($this->tmpFolder.$this->subFolder.'template_settings_types.json'), true);
  }
  else
  { // template_settings_types json file not found
  $templateSettingsTypes = '';
  sys::setSyslog($db, 48, 1, "failed to get ".$this->tmpFolder.$this->subFolder."template_settings_types.json - file not found", 0, 0, 0, 0);
  }
  
  // read templates.json into array
  if (is_file($this->tmpFolder.$this->subFolder.'templates.json'))
  { // read and decode json into array
  $templates = json_decode(file_get_contents($this->tmpFolder.$this->subFolder.'templates.json'), true);
  }
  else
  { // templates.json file not found
  $templates = '';
  sys::setSyslog($db, 48, 1, "failed to get ".$this->tmpFolder.$this->subFolder."templates.json - file not found", 0, 0, 0, 0);
  }
  
  // check if template with same name exists
  if ($this->checkIfTemplateAlreadyExists($db, $iniFile['NAME']) === true)
  {
  // die('template already exists');
  
  // TEMPLATE ALREADY EXISTS - OVERWRITE IT!
  // .) check, which ID got this template?
  // .) manipulate assets + template_settings arrays
  // (means: change template ID to the one of the existing template that was found)
  // .) UPDATE data of these arrays into related db tables
  // .) delete json files from tmp folder (unwanted in target)
  // .) xcopy files and overwrite template folder
  // .) empty tmp directory
  // -fin- template updated - if all went good
  
  // get ID of installed template
  $this->id = self::getTemplateIdByName($db, $iniFile['NAME']);
  
  // update ID in templates array
  $templates['id'] = $this->id;
  
  // update ID in assets array
  foreach ($assets as &$asset)
  {
  $asset['templateID'] = $this->id;
  }
  
  // update ID in template_settings array
  foreach ($templateSettings as &$templateSetting)
  {
  $templateSetting['templateID'] = $this->id;
  }
  
  if ($db->query("UPDATE {templates} 
  SET id = '".$this->id."',
  active = 1,
  name = '".$iniFile['NAME']."',
  positions ='outerTop:outerLeft:outerRight:intro:globalmenu:top:leftMenu:mainTop:mainTopLeft:mainTopCenter:mainTopRight:main:mainBottom:mainBottomLeft:mainBottomCenter:mainBottomRight:mainFooter:mainFooterLeft:mainFooterCenter:mainFooterRight:rightMenu:bottom:footer:hiddentoolbar:debug:outerBottom',
  description = '".$iniFile['DESCRIPTION']."',
  modifyDate = '".$iniFile['DATE']."',
  author = '".$iniFile['AUTHOR']."',
  authorUrl = '".$iniFile['AUTHOR_URL']."',
  weblink = '".$iniFile['WEBLINK']."',
  subAuthor = '".$iniFile['SUB_AUTHOR']."',
  subAuthorUrl = '".$iniFile['SUB_AUTHOR_URL']."',
  version = '".$iniFile['VERSION']."',
  framework = '".$iniFile['FRAMEWORK']."',
  license = '".$iniFile['LICENSE']."'
  WHERE name = '".$iniFile['NAME']."'"))
  {
  // success: updated templates database
  // \YAWK\sys::setSyslog($db, 45, 0, "template $iniFile[NAME] - templates db updated", 0, 0, 0, 0);
  }
  else
  { // error: failed to update templates db
  sys::setSyslog($db, 47, 0, "failed to update template $iniFile[NAME] - templates db NOT updated", 0, 0, 0, 0);
  }
  
  // update assets database
  foreach ($assets as $asset)
  {
  if ($db->query("UPDATE {assets} 
  SET templateID = '".$this->id."',
  type = '".$asset['type']."',
  sortation = '".$asset['sortation']."',
  asset = '".$asset['asset']."',
  link = '".$asset['link']."'
  WHERE link = '".$asset['link']."' AND templateID = '".$iniFile['ID']."'"))
  {
  // success: updated templates database
  // \YAWK\sys::setSyslog($db, 45, 0, "template $iniFile[NAME] - assets db updated", 0, 0, 0, 0);
  }
  else
  { // error: failed to update templates db
  sys::setSyslog($db, 47, 0, "failed to update template $iniFile[NAME] - assets db NOT updated", 0, 0, 0, 0);
  }
  // process asset data
  }
  
  // update template_settings database
  
  foreach ($templateSettings as $templateSetting)
  {
  if ($db->query("UPDATE {template_settings} 
  SET templateID = '".$this->id."',
  property = '".$templateSetting['property']."',
  value = '".$templateSetting['value']."',
  valueDefault = '".$templateSetting['valueDefault']."',
  longValue = '".$templateSetting['longValue']."',
  type = '".$templateSetting['type']."',
  activated = '".$templateSetting['activated']."',
  sort = '".$templateSetting['sort']."',
  label = '".$templateSetting['label']."',
  fieldClass = '".$templateSetting['fieldClass']."',
  fieldType = '".$templateSetting['fieldType']."',
  options = '".$templateSetting['options']."',
  placeholder = '".$templateSetting['placeholder']."',
  description = '".$templateSetting['description']."',
  icon = '".$templateSetting['icon']."',
  heading = '".$templateSetting['heading']."',
  subtext = '".$templateSetting['subtext']."'
  WHERE property = '".$templateSetting['property']."' AND templateID = '".$iniFile['ID']."'"))
  {
  // success: updated templates database
  // \YAWK\sys::setSyslog($db, 45, 0, "template $iniFile[NAME] - template_settings db updated", 0, 0, 0, 0);
  }
  else
  { // error: failed to update templates db
  sys::setSyslog($db, 47, 0, "failed to update property $templateSetting[property] of template $iniFile[NAME] - template_settings db NOT updated", 0, 0, 0, 0);
  }
  }
  
  // update template settings types
  foreach ($templateSettingsTypes as $templateSettingsType)
  {
  if ($db->query("UPDATE {template_settings_types} 
  SET type = '".$templateSettingsType['type']."'
  WHERE type = '".$templateSettingsType['type']."'"))
  {
  // success: updated templates database
  // \YAWK\sys::setSyslog($db, 45, 0, "template $iniFile[NAME] - template_settings db updated", 0, 0, 0, 0);
  }
  else
  { // error: failed to update templates db
  sys::setSyslog($db, 47, 0, "failed to update type $templateSettingsType[type] - template_settings_types db NOT updated", 0, 0, 0, 0);
  }
  }
  
  // delete unwanted json files - they are not needed anymore
  if (!unlink ($this->tmpFolder.$this->subFolder."assets.json"))
  {
  sys::setSyslog($db, 47, 0, "failed to delete ".$this->tmpFolder.$this->subFolder."assets.json", 0, 0, 0, 0);
  }
  if (!unlink ($this->tmpFolder.$this->subFolder."template_settings.json"))
  {
  sys::setSyslog($db, 47, 0, "failed to delete ".$this->tmpFolder.$this->subFolder."template_settings.json", 0, 0, 0, 0);
  }
  if (!unlink ($this->tmpFolder.$this->subFolder."template_settings_types.json"))
  {
  sys::setSyslog($db, 47, 0, "failed to delete ".$this->tmpFolder.$this->subFolder."template_settings_types.json", 0, 0, 0, 0);
  }
  if (!unlink ($this->tmpFolder.$this->subFolder."templates.json"))
  {
  sys::setSyslog($db, 47, 0, "failed to delete ".$this->tmpFolder.$this->subFolder."templates.json", 0, 0, 0, 0);
  }
  
  // copy template folder
  sys::xcopy($this->tmpFolder.$this->subFolder, $this->folder.$this->subFolder);
  
  // remove tmp folder
  if (!\YAWK\filemanager::recursiveRemoveDirectory($this->tmpFolder))
  { // failed to remove tmp folder
  sys::setSyslog($db, 47, 0, "failed to remove tmp folder $this->tmpFolder", 0, 0, 0, 0);
  }
  
  // create a fresh, empty tmp folder
  mkdir($this->tmpFolder);
  return true;
  }
  else
  {
  // TEMPLATE DOES NOT EXIST YET - INSTALL IT!
  // 1.) add template to templates database
  // 2.) retrieve ID of this new added template
  // 3.) manipulate assets + template_settings arrays
  // (means: change template ID to the new created one)
  //
  // 4.) INSERT data of these arrays into related db tables
  // 5.) delete json files from tmp folder (unwanted in target)
  // 6.) delete ini file (unwanted in target)
  // 7.) next step - xcopy files
  // -fin- template installed - if all went good
  // die('template does not exist');
  
  // step 1.) add template to templates database
  if ($res = $db->query("INSERT INTO {templates} (active, name, positions, description, releaseDate, modifyDate, author, authorUrl, weblink, subAuthor, subAuthorUrl, version, framework, license)
  VALUES ('1', 
  '".$iniFile['NAME']."', 
  'outerTop:outerLeft:outerRight:intro:globalmenu:top:leftMenu:mainTop:mainTopLeft:mainTopCenter:mainTopRight:main:mainBottom:mainBottomLeft:mainBottomCenter:mainBottomRight:mainFooter:mainFooterLeft:mainFooterCenter:mainFooterRight:rightMenu:bottom:footer:hiddentoolbar:debug:outerBottom', 
  '".$iniFile['DESCRIPTION']."', 
  '".$iniFile['DATE']."', 
  '".$iniFile['DATE']."', 
  '".$iniFile['AUTHOR']."', 
  '".$iniFile['AUTHOR_URL']."', 
  '".$iniFile['WEBLINK']."', 
  '".$iniFile['SUB_AUTHOR']."', 
  '".$iniFile['SUB_AUTHOR_URL']."', 
  '".$iniFile['VERSION']."', 
  '".$iniFile['FRAMEWORK']."', 
  '".$iniFile['LICENSE']."')"))
  {
  
  // 2.) retrieve ID of this new added template
  $this->id = self::getTemplateIdByName($db, $iniFile['NAME']);
  
  // add assets to database
  foreach ($assets as $asset)
  {
  $db->query("INSERT INTO {assets} (templateID, type, sortation, asset, link)
  VALUES (
  '".$this->id."',
  '".$asset['type']."',
  '".$asset['sortation']."',
  '".$asset['asset']."',
  '".$asset['link']."'
  )");
  }
  
  // add template settings to database
  foreach ($templateSettings as $templateSetting)
  {
  $db->query("INSERT INTO {template_settings} 
  (templateID, property, value, valueDefault, longValue, type, activated, sort, label, fieldClass, fieldType, options, placeholder, description, icon, heading, subtext)
  VALUES ('".$this->id."',
  '".$templateSetting['property']."',
  '".$templateSetting['value']."',
  '".$templateSetting['valueDefault']."',
  '".$templateSetting['longValue']."',
  '".$templateSetting['type']."',
  '".$templateSetting['activated']."',
  '".$templateSetting['sort']."',
  '".$templateSetting['label']."',
  '".$templateSetting['fieldClass']."',
  '".$templateSetting['fieldType']."',
  '".$templateSetting['options']."',
  '".$templateSetting['placeholder']."',
  '".$templateSetting['description']."',
  '".$templateSetting['icon']."',
  '".$templateSetting['heading']."',
  '".$templateSetting['subtext']."')");
  }
  
  // delete unwanted json files - they are not needed anymore
  if (!unlink ($this->tmpFolder.$this->subFolder."assets.json"))
  {
  sys::setSyslog($db, 47, 0, "failed to delete ".$this->tmpFolder.$this->subFolder."assets.json", 0, 0, 0, 0);
  }
  if (!unlink ($this->tmpFolder.$this->subFolder."template_settings.json"))
  {
  sys::setSyslog($db, 47, 0, "failed to delete ".$this->tmpFolder.$this->subFolder."template_settings.json", 0, 0, 0, 0);
  }
  if (!unlink ($this->tmpFolder.$this->subFolder."template_settings_types.json"))
  {
  sys::setSyslog($db, 47, 0, "failed to delete ".$this->tmpFolder.$this->subFolder."template_settings_types.json", 0, 0, 0, 0);
  }
  if (!unlink ($this->tmpFolder.$this->subFolder."templates.json"))
  {
  sys::setSyslog($db, 47, 0, "failed to delete ".$this->tmpFolder.$this->subFolder."templates.json", 0, 0, 0, 0);
  }
  
  // copy template folder
  sys::xcopy($this->tmpFolder.$this->subFolder, $this->folder.$this->subFolder);
  
  // remove tmp folder
  if (!\YAWK\filemanager::recursiveRemoveDirectory($this->tmpFolder))
  { // failed to remove tmp folder
  sys::setSyslog($db, 47, 0, "failed to remove tmp folder $this->tmpFolder", 0, 0, 0, 0);
  }
  
  // create a fresh, empty tmp folder
  mkdir($this->tmpFolder);
  
  // success: updated templates database
  sys::setSyslog($db, 45, 0, "added template <b>$iniFile[NAME] ID: ".$this->id."</b> to templates db", 0, 0, 0, 0);
  return true;
  
  }
  else
  { // error: failed to insert new template into db
  sys::setSyslog($db, 47, 0, "failed to insert new template: $iniFile[NAME] - templates db NOT updated", 0, 0, 0, 0);
  }
  
  }
  
  // xcopy files
  // recursive delete tmp folder
  
  // throw success message
  sys::setSyslog($db, 46, 3, "uploaded template package $this->uploadFile successfully", 0, 0, 0, 0);
  }
  else
  { // failed to check uploaded file - file not found
  sys::setSyslog($db, 48, 1, "failed to check uploaded file upload file: $this->uploadFile not found", 0, 0, 0, 0);
  }
  }
  }
  }
  else
  { // tmp folder does not exist
  sys::setSyslog($db, 48, 1, "failed to uploaded tempalte: ../system/templates/tmp/ does not exist or is not accessable", 0, 0, 0, 0);
  return false;
  }
  }
  else
  { // tmp folder is not writeable
  sys::setSyslog($db, 48, 1, "failed to uploaded template: $this->folder is not writeable", 0, 0, 0, 0);
  return false;
  }
  
  // if something else went wrong
  return false;
  }

References $db, YAWK\template\$id, $res, $templateSettings, YAWK\template\checkIfTemplateAlreadyExists(), YAWK\template\emptyTmpFolder(), YAWK\filemanager\recursiveRemoveDirectory(), and YAWK\sys\xcopy().

Member Data Documentation

◆ $active

YAWK\template::$active

Parameters

int 0|1 is this template active?

Definition at line 22 of file template.php.

◆ $author

YAWK\template::$author

Parameters

string author of this template

Definition at line 44 of file template.php.

Referenced by YAWK\template\downloadTemplate().

◆ $authorUrl

YAWK\template::$authorUrl

Parameters

string author's url

Definition at line 46 of file template.php.

Referenced by YAWK\template\downloadTemplate().

◆ $bootstrapVersion

YAWK\template::$bootstrapVersion

Parameters

string the current loaded Bootstrap version

Definition at line 58 of file template.php.

◆ $config

YAWK\template::$config

Parameters

array db config array

Definition at line 28 of file template.php.

◆ $description

YAWK\template::$description

Parameters

string template description

Definition at line 40 of file template.php.

Referenced by YAWK\template\downloadTemplate().

◆ $folder

YAWK\template::$folder = '../system/templates/'

Parameters

string template folder (root path of all templates)

Definition at line 30 of file template.php.

Referenced by YAWK\template\downloadTemplate(), and YAWK\template\getFontsFromFolder().

◆ $framework

YAWK\template::$framework = 'bootstrap4'

Parameters

string required framework for this template

Definition at line 60 of file template.php.

Referenced by YAWK\template\downloadTemplate().

◆ $id

YAWK\template::$id

Parameters

int template ID

Definition at line 18 of file template.php.

Referenced by YAWK\template\downloadTemplate(), YAWK\template\loadAllSettingsIntoArray(), YAWK\template\loadProperties(), YAWK\template\loadPropertiesIntoArray(), YAWK\template\saveProperties(), and YAWK\template\uploadTemplate().

◆ $license

YAWK\template::$license

Parameters

string template's license

Definition at line 62 of file template.php.

Referenced by YAWK\template\downloadTemplate().

◆ $modifyDate

YAWK\template::$modifyDate

Parameters

string datetime when this template was modified

Definition at line 54 of file template.php.

◆ $name

YAWK\template::$name

Parameters

string template name

Definition at line 24 of file template.php.

Referenced by YAWK\template\checkIfTemplateAlreadyExists(), and YAWK\template\downloadTemplate().

◆ $newId

YAWK\template::$newId

Parameters

int new TPL ID (latest template)

Definition at line 20 of file template.php.

◆ $newTplName

YAWK\template::$newTplName

Parameters

string new template name

Definition at line 26 of file template.php.

◆ $positions

YAWK\template::$positions

Parameters

string positions as string

Definition at line 38 of file template.php.

Referenced by YAWK\template\getPositionDivBox().

◆ $releaseDate

YAWK\template::$releaseDate

Parameters

string datetime when this template was released

Definition at line 42 of file template.php.

◆ $selectedTemplate

int YAWK\template::$selectedTemplate

Parameters

int which template is currently set to active?

Definition at line 64 of file template.php.

◆ $subAuthor

YAWK\template::$subAuthor = ''

Parameters

string sub-author who has modified the template

Definition at line 50 of file template.php.

Referenced by YAWK\template\downloadTemplate().

◆ $subAuthorUrl

YAWK\template::$subAuthorUrl = ''

Parameters

string sub-author's url

Definition at line 52 of file template.php.

Referenced by YAWK\template\downloadTemplate().

◆ $subFolder

YAWK\template::$subFolder

Parameters

string template sub folder (template name, eg. ../system/templates/SUBFOLDER

Definition at line 36 of file template.php.

Referenced by YAWK\template\downloadTemplate().

◆ $tmpFolder

YAWK\template::$tmpFolder = '../system/templates/tmp/'

Parameters

string template tmp folder (where uploads will be unpacked)

Definition at line 32 of file template.php.

Referenced by YAWK\template\downloadTemplate().

◆ $ttfPath

string YAWK\template::$ttfPath = '../system/fonts/'

Parameters

string path to custom fonts (ttf|otf|woff)

Definition at line 66 of file template.php.

◆ $uploadFile

YAWK\template::$uploadFile = ''

Parameters

string upload file (including complete path)

Definition at line 34 of file template.php.

◆ $version

YAWK\template::$version

Parameters

string template's version number

Definition at line 56 of file template.php.

Referenced by YAWK\template\downloadTemplate().

◆ $weblink

YAWK\template::$weblink

Parameters

string weblink to this template

Definition at line 48 of file template.php.

Referenced by YAWK\template\downloadTemplate().

The documentation for this class was generated from the following file:

/var/www/htdocs/yawk.io/system/classes/template.php

Public Member Functions

Static Public Member Functions

Public Attributes

Detailed Description

Member Function Documentation

◆ checkIfTemplateAlreadyExists()

◆ checkWrapper()

◆ deleteSettingsCSSFile()

◆ downloadTemplate()

◆ drawAssetsSelectFields()

◆ drawAssetsTitles()

◆ drawFontFamilySelectField()

◆ emptyTmpFolder()

◆ getActiveBodyFont()

◆ getActivegfont()

◆ getAllSettingsIntoArray()

◆ getAssetsByType()

◆ getCurrentTemplateId()

◆ getCustomCSSFile()

◆ getCustomJSFile()

◆ getFontRow()

◆ getFontsFromFolder()

◆ getFormElements()

◆ getGoogleFontsArray()

◆ getMaxId()

◆ getPositionDivBox()

◆ getPositionIndicatorStatusArray()

◆ getPositionStatesArray()

◆ getTemplateIds()

◆ getTemplateSettingsArray()

◆ getValidTemplateID()

◆ includeHeader()

◆ loadActiveAssets()

◆ loadActiveAssetsIntoArray()

◆ loadAllSettingsIntoArray()

◆ loadGoogleFonts()

◆ loadProperties()

◆ loadPropertiesIntoArray()

◆ loadSettingsTypesIntoArray()

◆ returnCurrentBootstrapVersion()

◆ saveAs()

◆ saveProperties()

◆ setCssBodyFontFace()

◆ setCssBodyFontSettings()

◆ setCssBodyLinkTags()

◆ setCssBodySmallFontSettings()

◆ setCssFontSettings()

◆ setPosition()

◆ switchPositionIndicators()

◆ uploadTemplate()

Member Data Documentation

◆ $active

◆ $author

◆ $authorUrl

◆ $bootstrapVersion

◆ $config

◆ $description

◆ $folder

◆ $framework

◆ $id

◆ $license

◆ $modifyDate

◆ $name

◆ $newId

◆ $newTplName

◆ $positions

◆ $releaseDate

◆ $selectedTemplate

◆ $subAuthor

◆ $subAuthorUrl

◆ $subFolder

◆ $tmpFolder

◆ $ttfPath

◆ $uploadFile

◆ $version

◆ $weblink