system/modules/sg-elements/core/library/SgElements/SgElements.php line 44

Open in your IDE?
  1. <?php
  3. /**
  4.  * Contao Open Source CMS
  5.  *
  6.  * Copyright (c) 2005-2015 Leo Feyer
  7.  *
  8.  * @package   SgElements
  9.  * @author    Sg-Medien GmbH <info@sg-medien.com>
  10.  * @license   EULA
  11.  * @copyright Sg-Medien GmbH 2015
  12.  */
  15. /**
  16.  * Set custom namespace
  17.  */
  18. namespace SgM;
  21. use Contao\StringUtil;
  23. /**
  24.  * Class SgElements
  25.  *
  26.  * Base class for "SgElements".
  27.  *
  28.  * @package   SgElements
  29.  * @author    Sg-Medien GmbH <info@sg-medien.com>
  30.  * @copyright Sg-Medien GmbH 2015
  31.  */
  32. class SgElements
  33. {
  35.     /**
  36.      * Contao hook to add specific classes to a content element or an article.
  37.      *
  38.      * @param object $objElement The contao content element object or the article object.
  39.      * @param string $strBuffer The parsed html code of the contao content element or nothing for an article.
  40.      *
  41.      * @return string The modified html code of the contao content element
  42.      *
  43.      */
  44.     public function addClasses($objElement, $strBuffer=false)
  45.     {
  46.         if('FE' !== TL_MODE)
  47.         {
  48.             return $strBuffer;
  49.         }
  51.         // get classes
  52.         $classes = array();
  53.         $cssID = StringUtil::deserialize($objElement->cssID, true);
  55.         if(!empty($cssID)) {
  56.             $classes = explode(' ', $cssID[1]);
  57.         }
  58.         $startClassChecksum = md5(serialize($classes));
  60.         // if contao content element
  61.         if ($strBuffer)
  62.         {
  63.             // add space class if set and not "defspace"
  64.             if ($objElement->space_class)
  65.             {
  66.                 $classes[] = $objElement->space_class;
  67.             }
  69.             // add withbg class if set
  70.             if ($objElement->withbg_class)
  71.             {
  72.                 $classes[] = 'withbg';
  73.             }
  75.             // remove duplicate classes
  76.             #$classes = array_unique($classes, SORT_REGULAR);
  77.             $endClassChecksum = md5(serialize($classes));
  79.             // only if classes changed
  80.             if ($startClassChecksum!=$endClassChecksum)
  81.             {
  82.                 // try to use the real object to inject the space class
  83.                 $strCte = '';
  84.                 foreach($GLOBALS['TL_CTE'] AS $node => $arrTypes)
  85.                 {
  86.                     foreach($arrTypes AS $type => $class)
  87.                     {
  88.                         if ($type == $objElement->type)
  89.                         {
  90.                             $strCte = $GLOBALS['TL_CTE'][$node][$type];
  91.                         }
  92.                     }
  93.                 }
  95.                 // if real object found
  96.                 if(strlen($strCte) > 0)
  97.                 {
  98.                     $objCte = new $strCte($objElement);
  99.                     $cssID[1] = trim(implode(' ', $classes));
  100.                     $objCte->cssID = $cssID;
  101.                     
  102.                     try {
  103.                         $strBuffer = $objCte->generate();
  104.                     } catch (\Exception $objError) {
  105.                         //
  106.                     }
  107.                 }
  108.                 // fallback: inject classes with rewriting the class attribute
  109.                 else
  110.                 {
  111.                     $preg = preg_match('/class="(.*?)\"/', $strBuffer, $result);
  112.                     if($preg)
  113.                     {
  114.                        $class = explode(' ', $result[1]);
  115.                        $classes = array_unique(array_merge($classes, $class));
  116.                     }
  117.                     $strBuffer = preg_replace('/class="(.*?)\"/', 'class="'.trim(implode(' ', $classes)).'"', $strBuffer);
  118.                 }
  119.             }
  121.             return $strBuffer;
  122.         }
  124.         // or if an article
  126.         // add space class if set and not "nospace"
  127.         if ($objElement->space_class && $objElement->space_class !== 'nospace')
  128.         {
  129.             $classes[] = $objElement->space_class;
  130.         }
  132.         // add withbg class if set
  133.         if ($objElement->withbg_class)
  134.         {
  135.             $classes[] = 'withbg';
  136.         }
  138.         // remove duplicate classes
  139.         $classes          = array_unique($classes);
  140.         $endClassChecksum = md5(serialize($classes));
  142.         // only if classes changed
  143.         if ($startClassChecksum != $endClassChecksum)
  144.         {
  145.             // write classes back
  146.             $cssID[1] = trim(implode(' ', $classes));
  147.             $objElement->cssID = $cssID;
  148.         }
  150.         return $strBuffer;
  151.     }
  154.     /**
  155.      * Contao hook to check if the element is a wrapper and if yes, get id of wrapper for the child elements.
  156.      *
  157.      * @param object $objElement The contao content element object.
  158.      * @param string $strBuffer The parsed html code of the contao content element.
  159.      *
  160.      * @return string The same html code of the contao content element.
  161.      *
  162.      */
  163.     public function checkWrapper($objElement, $strBuffer)
  164.     {
  165.         if (!isset($GLOBALS['TL_WRAPPERS']) OR !is_array($GLOBALS['TL_WRAPPERS']['start']))
  166.         {
  167.             return $strBuffer;
  168.         }
  170.         if (in_array($objElement->type, $GLOBALS['TL_WRAPPERS']['start']))
  171.         {
  172.             $GLOBALS['SG_ELEMENTS']['wrapper'][$objElement->type][] = $objElement->id;
  173.         }
  175.         if (in_array($objElement->type, $GLOBALS['TL_WRAPPERS']['stop']))
  176.         {
  177.             // try to find start element belonging to current stop element
  178.             $arrIndex = array_search($objElement->type, $GLOBALS['TL_WRAPPERS']['stop']);
  179.             if (isset($GLOBALS['TL_WRAPPERS']['start'][$arrIndex]))
  180.             {
  181.                 $startWrapper = $GLOBALS['TL_WRAPPERS']['start'][$arrIndex];
  182.                 if (isset($GLOBALS['SG_ELEMENTS']['wrapper'][$startWrapper]) AND !empty($GLOBALS['SG_ELEMENTS']['wrapper'][$startWrapper]))
  183.                 {
  184.                     // remove last start wrapper
  185.                     end($GLOBALS['SG_ELEMENTS']['wrapper'][$startWrapper]);
  186.                     $lwk = key($GLOBALS['SG_ELEMENTS']['wrapper'][$startWrapper]);
  187.                     unset($GLOBALS['SG_ELEMENTS']['wrapper'][$startWrapper][$lwk]);
  188.                 }
  189.             }
  190.         }
  192.         return $strBuffer;
  193.     }
  196.     /**
  197.      * Method to get the id of current wrapper from a child element.
  198.      *
  199.      * @param string $wrapperName The name of the start wrapper.
  200.      *
  201.      * @return integer|boolean The id of the current wrapper or false if no wrapper found.
  202.      *
  203.      */
  204.     public static function getWrapperId($wrapperName)
  205.     {
  206.         if (!empty($wrapperName) AND isset($GLOBALS['SG_ELEMENTS']['wrapper'][$wrapperName]) AND !empty($GLOBALS['SG_ELEMENTS']['wrapper'][$wrapperName]))
  207.         {
  208.             return end($GLOBALS['SG_ELEMENTS']['wrapper'][$wrapperName]);
  209.         }
  210.         return false;
  211.     }
  214.     /**
  215.      * Add dynamic assets if required.
  216.      *
  217.      * @param string $assetsName The name of the assets lib defined in the config
  218.      *
  219.      * @return void
  220.      */
  221.     public static function addDynamicAssets($assetsName=false)
  222.     {
  223.         if (!$assetsName OR empty($assetsName) OR !is_string($assetsName))
  224.         {
  225.             return;
  226.         }
  228.         // add dynamic css libs
  229.         if (isset($GLOBALS['SG_ELEMENTS']['css']) AND isset($GLOBALS['SG_ELEMENTS']['css'][$assetsName]) AND is_array($GLOBALS['SG_ELEMENTS']['css'][$assetsName]))
  230.         {
  231.             foreach($GLOBALS['SG_ELEMENTS']['css'][$assetsName] AS $css)
  232.             {
  233.                 $GLOBALS['TL_CSS'][] = $css.'||static';
  234.             }
  235.         }
  237.         // add dynamic javascript libs
  238.         if (isset($GLOBALS['SG_ELEMENTS']['js']) AND isset($GLOBALS['SG_ELEMENTS']['js'][$assetsName]) AND is_array($GLOBALS['SG_ELEMENTS']['js'][$assetsName]))
  239.         {
  240.             foreach($GLOBALS['SG_ELEMENTS']['js'][$assetsName] AS $js)
  241.             {
  242.                 $GLOBALS['TL_JAVASCRIPT'][] = $js.'|static';
  243.             }
  244.         }
  245.     }
  248.     /**
  249.      * Get Vimeo-Video-HTML.
  250.      *
  251.      * @param string $vimeoID The ID of the Vimeo-Video.
  252.      * @param string $playerSize The width and the height in html attributes (e.g. width="640" height="360").
  253.      * @param string $playerColor The player color as hex code without a the hash tag (default: #00adef).
  254.      * @param boolean $showTitle Show the title of the video (default: false).
  255.      * @param boolean $showUserImage Show the user's portrait on the video (default: false).
  256.      * @param boolean $showUserByline Show the user’s byline on the video (default: false).
  257.      * @param boolean $autoplay Activate "autoplay" for video (default: false).
  258.      * @param boolean $playerID A unique player id (default: false).
  259.      * @param boolean $activateApi Activate the vimeo api (default: false).
  260.      *
  261.      * @return string The Vimeo-HTML-Code
  262.      */
  263.     public static function getVimeoVideo($vimeoID=false, $playerSize=false, $playerColor=false, $showTitle=false, $showUserImage=false, $showUserByline=false, $autoplay=false, $playerID=false, $activateApi=false)
  264.     {
  265.         // only if Vimeo-ID given
  266.         if (!$vimeoID OR empty($vimeoID) OR !is_string($vimeoID))
  267.         {
  268.             return false;
  269.         }
  271.         // video options array
  272.         $videoOptions = array();
  274.         // set player color
  275.         if (is_string($playerColor) AND !empty($playerColor))
  276.         {
  277.             $videoOptions[] = 'color='.urlencode($playerColor);
  278.         }
  280.         // show no video title
  281.         if (!$showTitle)
  282.         {
  283.             $videoOptions[] = 'title=0';
  284.         }
  286.         // show no user portrait
  287.         if (!$showUserImage)
  288.         {
  289.             $videoOptions[] = 'portrait=0';
  290.         }
  292.         // show no user byline
  293.         if (!$showUserImage)
  294.         {
  295.             $videoOptions[] = 'byline=0';
  296.         }
  298.         // autoplay?
  299.         if ($autoplay)
  300.         {
  301.             $videoOptions[] = 'autoplay=1';
  302.         }
  304.         // use a unique player id
  305.         if ($playerID)
  306.         {
  307.             $videoOptions[] = 'player_id='.urlencode($playerID);
  308.         }
  310.         // activate the vimeo api
  311.         if ($activateApi)
  312.         {
  313.             $videoOptions[] = 'api=1';
  314.         }
  316.         // return final Vimeo-HTML-Code
  317.         return '<iframe'.(($playerSize AND !empty($playerSize)) ? $playerSize : '').' src="//player.vimeo.com/video/'.$vimeoID.(count($videoOptions) ? '?'.implode('&amp;', $videoOptions)  : '').'" frameborder="0" webkitallowfullscreen mozallowfullscreen allowfullscreen></iframe>';
  318.     }
  321.     /**
  322.      * Add a request string to an URL.
  323.      *
  324.      * @param string  $strRequest The string to be added
  325.      * @param array   $arrUnset An optional array of keys to unset
  326.      * @param string  $strUrl An optional url instead of the current url
  327.      * @param boolean $blnAddRef Add the referer ID
  328.      * @param boolean $blnAddCurQueries Add the current queries
  329.      *
  330.      * @return string The new URL
  331.      */
  332.     public static function addToUrl($strRequest, $arrUnset=array(), $strUrl=false, $blnAddRef=false, $blnAddCurQueries=true)
  333.     {
  334.         $strRequest = preg_replace('/^&(amp;)?/i', '', $strRequest);
  336.         if ($strRequest != '' && $blnAddRef)
  337.         {
  338.             $strRequest .= '&amp;ref=' . TL_REFERER_ID;
  339.         }
  341.         $queries = $blnAddCurQueries ? preg_split('/&(amp;)?/i', \Environment::get('queryString')) : array();
  343.         // overwrite existing parameters
  344.         foreach ($queries as $k=>$v)
  345.         {
  346.             list($key) = explode('=', $v);
  348.             if (in_array($key, $arrUnset) OR preg_match('/(^|&(amp;)?)' . preg_quote($key, '/') . '=/i', $strRequest) OR empty($v))
  349.             {
  350.                 unset($queries[$k]);
  351.             }
  352.         }
  354.         $href = '?';
  356.         if (!empty($queries))
  357.         {
  358.             $href .= implode('&amp;', $queries) . '&amp;';
  359.         }
  361.         return preg_replace('/((&(amp;)?)|\?)$/', '', trim(((is_string($strUrl) AND !empty($strUrl)) ? $strUrl : ampersand(preg_replace('/\?.*?$/', '', \Environment::get('request')))).$href.str_replace(' ', '%20', $strRequest)));
  362.     }
  365.     /**
  366.      * Sort a multidimensional array according to a defined field (ascending or descending).
  367.      *
  368.      * @param array $multiArray
  369.      * @param string $fieldName
  370.      * @param string $sortDirection
  371.      *
  372.      * @return array
  373.      */
  374.     public static function arrayMultiSort($multiArray, $fieldName, $sortDirection='asc')
  375.     {
  376.         $sortMultiArray = array();
  378.         foreach($multiArray AS $key => $data)
  379.         {
  380.             ${$fieldName}[$key] = $data[$fieldName];
  381.         }
  383.         if (${$fieldName}!==null)
  384.         {
  385.             if ($sortDirection!=='asc')
  386.             {
  387.                 arsort(${$fieldName});
  388.             }
  389.             else
  390.             {
  391.                 asort(${$fieldName});
  392.             }
  393.             foreach (${$fieldName} AS $key => $value)
  394.             {
  395.                 $sortMultiArray[] = $multiArray[$key];
  396.             }
  397.         }
  399.         return $sortMultiArray;
  400.     }
  403.     /**
  404.      * Process backend ajax requests.
  405.      *
  406.      * @param string $strAction The name of the ajax action.
  407.      * @param object $dc The data container object.
  408.      *
  409.      * @return void
  410.      */
  411.     public function ajaxRequest($strAction, \DataContainer $dc)
  412.     {
  413.         switch ($strAction)
  414.         {
  415.             // file upload
  416.             case 'sg_ajaxupload':
  417.                 // get dca data
  418.                 $intId = ($dc->id!==null AND is_integer((int)$dc->id) AND (int)$dc->id>0) ? (int)$dc->id : 0;
  419.                 $strTable = ($dc->table!==null AND trim($dc->table)!='' AND isset($GLOBALS['TL_DCA'][trim($dc->table)])) ? trim($dc->table) : false;
  420.                 $strField = ($strTable AND \Input::post('name')!==null AND trim(\Input::post('name'))!='') ? trim(\Input::post('name')) : false;
  421.                 $strName = $strField;
  423.                 // handle the keys in "edit multiple" mode
  424.                 if ($strField!==false AND \Input::get('act') == 'editAll')
  425.                 {
  426.                     $intId = (int)preg_replace('/.*_([0-9a-zA-Z]+)$/', '$1', $strField);
  427.                     $strField = preg_replace('/(.*)_[0-9a-zA-Z]+$/', '$1', $strField);
  428.                     $strName = $strField.'_'.$intId;
  429.                 }
  431.                 // check if strField exists
  432.                 $strField = isset($GLOBALS['TL_DCA'][$strTable]['fields'][$strField]) ? $strField : false;
  434.                 // if error with the dca data, die...
  435.                 if ($intId===false OR $strTable===false OR $strField===false)
  436.                 {
  437.                     // if no id given
  438.                     if ($intId===false)
  439.                     {
  440.                         $this->log('No ID given for DCA "'.($strTable===false ? 'undefined' : $strTable).'"', __METHOD__, TL_ERROR);
  441.                     }
  442.                     // otherwise...
  443.                     else
  444.                     {
  445.                         $this->log('Field "'.($strField===false ? 'undefined' : $strField).'" does not exist in DCA "'.($strTable===false ? 'undefined' : $strTable).'"', __METHOD__, TL_ERROR);
  446.                     }
  447.                     header('HTTP/1.1 400 Bad Request');
  448.                     die('Bad Request');
  449.                 }
  451.                 // get current field value
  452.                 $objRow = \Database::getInstance()->prepare("SELECT ".$strField." FROM ".$strTable." WHERE id=?")->limit(1)->execute($intId);
  454.                 // if field value not exists, die...
  455.                 if ($objRow===null OR !$objRow->count())
  456.                 {
  457.                     $this->log('Could not load value for field "'.$strField.'" in DCA "'.$strTable.'" (given ID was: '.$intId.')', __METHOD__, TL_ERROR);
  458.                     header('HTTP/1.1 400 Bad Request');
  459.                     die('Bad Request');
  460.                 }
  462.                 // get current value
  463.                 $varValue = deserialize($objRow->{$strField});
  465.                 // initialize the widget
  466.                 $class = $GLOBALS['BE_FFL']['ajax_upload'];
  467.                 $objWidget = new $class($class::getAttributesFromDca($GLOBALS['TL_DCA'][$strTable]['fields'][$strField], $strName, $varValue, $strField, $strTable, $dc));
  469.                 // upload file
  470.                 $fileUpload = self::uploadFile($objWidget);
  472.                 if ($fileUpload['error'])
  473.                 {
  474.                     $arrResponse = array
  475.                     (
  476.                         'success' => false,
  477.                         'error' => $fileUpload['error'],
  478.                         'preventRetry' => true
  479.                     );
  480.                 }
  481.                 else
  482.                 {
  483.                     $arrResponse = array
  484.                     (
  485.                         'success' => true,
  486.                         'file' => $fileUpload['file'],
  487.                         'html' => $fileUpload['html']
  488.                     );
  489.                 }
  491.                 // return json response
  492.                 echo json_encode($arrResponse); exit;
  493.                 break;
  494.         }
  495.     }
  498.     /**
  499.      * Process a file upload.
  500.      *
  501.      * @param object $objWidget The widget object of the file upload.
  502.      *
  503.      * @return array The result of the file upload.
  504.      */
  505.     public static function uploadFile(\Widget $objWidget)
  506.     {
  507.         // validate and upload file
  508.         $strFile = $objWidget->validateUpload();
  510.         // default return
  511.         $arrReturn = array
  512.         (
  513.             'success' => false,
  514.             'error' => false,
  515.             'file' => false,
  516.             'html' => false
  517.         );
  519.         // check uploaded file
  520.         if ($objWidget->hasErrors())
  521.         {
  522.             $arrReturn['error'] = $objWidget->getErrorAsString();
  523.         }
  524.         else
  525.         {
  526.             // generate the file item
  527.             $generatedFile = $objWidget->generateFileItem(array('path' => $strFile));
  529.             // if error on file item generation
  530.             if (!$generatedFile)
  531.             {
  532.                 $arrReturn['error'] = $GLOBALS['TL_LANG']['MSC']['ajax_upload_errors']['unknown'];
  533.             }
  534.             else
  535.             {
  536.                 $arrReturn['success'] = true;
  537.                 $arrReturn['file'] = $strFile;
  538.                 $arrReturn['html'] = $generatedFile['html'];
  539.             }
  540.         }
  542.         // return response
  543.         return $arrReturn;
  544.     }
  547.     /**
  548.      * Add the required javascript files if an ajax upload field was added to the page.
  549.      *
  550.      * @param string $strName The name of the ajax upload field.
  551.      *
  552.      * @return void
  553.      */
  554.     public function addUploadAssets($strName)
  555.     {
  556.         if (isset($GLOBALS['TL_DCA'][$strName]) AND is_array($GLOBALS['TL_DCA'][$strName]['fields']))
  557.         {
  558.             foreach($GLOBALS['TL_DCA'][$strName]['fields'] AS $name => $field)
  559.             {
  560.                 if (isset($field['inputType']) AND $field['inputType']=='ajax_upload')
  561.                 {
  562.                     // add dynamic assets
  563.                     \SgElements::addDynamicAssets('ajax_upload');
  565.                     break;
  566.                 }
  567.             }
  568.         }
  569.     }
  572.     /**
  573.      * Form validators.
  574.      *
  575.      * @param string $strRegexp The name of the validation method.
  576.      * @param string $varValue The value of the field.
  577.      * @param object $objWidget A widget object.
  578.      *
  579.      * @return boolean If validation found true, otherwise false.
  580.      */
  581.     public function validation($strRegexp, $varValue, \Widget $objWidget)
  582.     {
  583.         if ($strRegexp=='integer')
  584.         {
  585.             if (!preg_match('/^[0-9]+$/', $varValue))
  586.             {
  587.                 $objWidget->addError(str_replace('%v', $varValue, str_replace('%s', $objWidget->label, $GLOBALS['TL_LANG']['MSC']['validationErrors']['integer'])));
  588.             }
  589.             return true;
  590.         }
  591.         else if ($strRegexp=='year')
  592.         {
  593.             if (!preg_match('/^[0-9]{4}$/', $varValue) OR (int)$varValue<1000)
  594.             {
  595.                 $objWidget->addError(str_replace('%v', $varValue, str_replace('%s', $objWidget->label, $GLOBALS['TL_LANG']['MSC']['validationErrors']['year'])));
  596.             }
  597.             else if ($objWidget->year_from!==null AND (int)$varValue<(int)$objWidget->year_from)
  598.             {
  599.                 $objWidget->addError(str_replace('%e', $objWidget->year_from, str_replace('%v', $varValue, str_replace('%s', $objWidget->label, $GLOBALS['TL_LANG']['MSC']['validationErrors']['year_from']))));
  600.             }
  601.             else if ($objWidget->year_to!==null AND (int)$varValue>(int)$objWidget->year_to)
  602.             {
  603.                 $objWidget->addError(str_replace('%e', $objWidget->year_to, str_replace('%v', $varValue, str_replace('%s', $objWidget->label, $GLOBALS['TL_LANG']['MSC']['validationErrors']['year_to']))));
  604.             }
  605.             return true;
  606.         }
  607.         return false;
  608.     }
  611.     /**
  612.      * Transliterate a string.
  613.      *
  614.      * @param string $string The string to transliterate.
  615.      *
  616.      * @return string|boolean The transliteraded string or false.
  617.      */
  618.     public static function transliterate($string=false)
  619.     {
  620.         if (is_string($string))
  621.         {
  622.             $transliteration_array = array
  623.             (
  624.                 'ä' => 'ae',
  625.                 'Ä' => 'Ae',
  626.                 'ë' => 'e',
  627.                 'Ë' => 'e',
  628.                 'ï' => 'i',
  629.                 'Ï' => 'I',
  630.                 'ö' => 'oe',
  631.                 'Ö' => 'Oe',
  632.                 'ü' => 'ue',
  633.                 'Ü' => 'Ue',
  634.                 'ÿ' => 'y',
  635.                 'Ÿ' => 'Y',
  636.                 'ß' => 'ss',
  637.                 'á' => 'a',
  638.                 'Á' => 'A',
  639.                 'é' => 'e',
  640.                 'É' => 'E',
  641.                 'í' => 'i',
  642.                 'Í' => 'I',
  643.                 'ó' => 'o',
  644.                 'Ó' => 'O',
  645.                 'ú' => 'u',
  646.                 'Ú' => 'U',
  647.                 'ñ' => 'n',
  648.                 'Ñ' => 'N',
  649.                 'à' => 'a',
  650.                 'À' => 'A',
  651.                 'è' => 'e',
  652.                 'È' => 'E',
  653.                 'ì' => 'i',
  654.                 'Ì' => 'I',
  655.                 'ò' => 'o',
  656.                 'Ò' => 'O',
  657.                 'ù' => 'u',
  658.                 'Ù' => 'U',
  659.                 'â' => 'a',
  660.                 'Â' => 'A',
  661.                 'ê' => 'e',
  662.                 'Ê' => 'E',
  663.                 'î' => 'i',
  664.                 'Î' => 'I',
  665.                 'ô' => 'o',
  666.                 'Ô' => 'O',
  667.                 'û' => 'u',
  668.                 'Û' => 'U',
  669.                 'æ' => 'ae',
  670.                 'Æ' => 'oe',
  671.                 'œ' => 'ae',
  672.                 'Œ' => 'oe',
  673.                 'ç' => 'c',
  674.                 'Ç' => 'C',
  675.                 'ø' => 'oe',
  676.                 'Ø' => 'Oe',
  677.                 'č' => 'c',
  678.                 'Č' => 'C',
  679.                 'ď' => 'd',
  680.                 'Ď' => 'D',
  681.                 'ě' => 'e',
  682.                 'Ě' => 'E',
  683.                 'ň' => 'n',
  684.                 'Ň' => 'N',
  685.                 'ř' => 'r',
  686.                 'Ř' => 'R',
  687.                 'š' => 's',
  688.                 'Š' => 'S',
  689.                 'ť' => 't',
  690.                 'Ť' => 'T',
  691.                 'ů' => 'u',
  692.                 'Ů' => 'U',
  693.                 'ý' => 'y',
  694.                 'Ý' => 'Y',
  695.                 'ž' => 'z',
  696.                 'Ž' => 'Z',
  697.                 'ą' => 'a',
  698.                 'Ą' => 'A',
  699.                 'ć' => 'c',
  700.                 'Ć' => 'C',
  701.                 'ę' => 'e',
  702.                 'Ę' => 'E',
  703.                 'ł' => 'l',
  704.                 'Ł' => 'L',
  705.                 'ń' => 'n',
  706.                 'Ń' => 'N',
  707.                 'ś' => 's',
  708.                 'Ś' => 'S',
  709.                 'ź' => 'z',
  710.                 'Ź' => 'Z',
  711.                 'ż' => 'z',
  712.                 'Ż' => 'Z',
  713.                 'ğ' => 'g',
  714.                 'Ğ' => 'G',
  715.                 'i' => 'i',
  716.                 'İ' => 'I',
  717.                 'ı' => 'i',
  718.                 'I' => 'I',
  719.                 'ş' => 's',
  720.                 'Ş' => 'S',
  721.                 'а' => 'a',
  722.                 'А' => 'A',
  723.                 'б' => 'b',
  724.                 'Б' => 'B',
  725.                 'в' => 'v',
  726.                 'В' => 'V',
  727.                 'г' => 'g',
  728.                 'Г' => 'G',
  729.                 'д' => 'd',
  730.                 'Д' => 'D',
  731.                 'ё' => 'jo',
  732.                 'Ё' => 'Jo',
  733.                 'Е' => 'E',
  734.                 'е' => 'e',
  735.                 'Ж' => 'Zh',
  736.                 'ж' => 'zh',
  737.                 'З' => 'Z',
  738.                 'з' => 'z',
  739.                 'И' => 'I',
  740.                 'и' => 'i',
  741.                 'Й' => 'J',
  742.                 'й' => 'j',
  743.                 'К' => 'K',
  744.                 'к' => 'k',
  745.                 'Л' => 'L',
  746.                 'л' => 'l',
  747.                 'М' => 'M',
  748.                 'м' => 'm',
  749.                 'Н' => 'N',
  750.                 'н' => 'n',
  751.                 'О' => 'O',
  752.                 'о' => 'o',
  753.                 'П' => 'P',
  754.                 'п' => 'p',
  755.                 'Р' => 'R',
  756.                 'р' => 'r',
  757.                 'С' => 'S',
  758.                 'с' => 's',
  759.                 'Т' => 'T',
  760.                 'т' => 't',
  761.                 'У' => 'U',
  762.                 'у' => 'u',
  763.                 'ф' => 'f',
  764.                 'Ф' => 'F',
  765.                 'Х' => 'H',
  766.                 'х' => 'h',
  767.                 'Ц' => 'C',
  768.                 'ц' => 'c',
  769.                 'Ч' => 'Ch',
  770.                 'ч' => 'ch',
  771.                 'Ш' => 'Sh',
  772.                 'ш' => 'sh',
  773.                 'Щ' => 'Shh',
  774.                 'щ' => 'shh',
  775.                 'Ъ' => '',
  776.                 'ъ' => '',
  777.                 'ы' => 'y',
  778.                 'Ы' => 'Y',
  779.                 'Ь' => '',
  780.                 'ь' => '',
  781.                 'Э' => 'Je',
  782.                 'э' => 'je',
  783.                 'Ю' => 'Ju',
  784.                 'ю' => 'ju',
  785.                 'Я' => 'Ja',
  786.                 'я' => 'ja',
  787.                 'Ґ' => 'G',
  788.                 'ґ' => 'g',
  789.                 'Ў' => 'U',
  790.                 'ў' => 'u',
  791.                 'Є' => 'Je',
  792.                 'є' => 'je',
  793.                 'Ї' => 'Ji',
  794.                 'ї' => 'ji',
  795.                 'І' => 'I',
  796.                 'і' => 'i'
  797.             );
  798.             return strtr($string, $transliteration_array);
  799.         }
  800.         return false;
  801.     }
  804.     /**
  805.      * Convert a string to a valid alias.
  806.      *
  807.      * @param string $string The string to convert.
  808.      * @param boolean $strtolower Convert the string to lowercase?
  809.      * @param integer|boolean $length Limit the length of the string?
  810.      *
  811.      * @return string|boolean The converted string.
  812.      */
  813.     public static function strToValidAlias($string=false, $strtolower=true, $length=200)
  814.     {
  815.         $string = self::transliterate(preg_replace('/(\\r|\\n)+/s', ' ', $string));
  816.         if (is_string($string))
  817.         {
  818.             $replace_from = array
  819.             (
  820.                 '/(–|–|‐|‐|‐|‐|\s|\/|\\\|,|;|:|\*|#|\+)+/',
  821.                 '/([^\.^a-z^0-9^-])/i',
  822.                 '/-+/',
  823.                 '/-+$/',
  824.                 '/^-+/'
  825.             );
  826.             $replace_to = array
  827.             (
  828.                 '-',
  829.                 '',
  830.                 '-',
  831.                 '',
  832.                 ''
  833.             );
  835.             $string = preg_replace($replace_from, $replace_to, trim($string));
  836.             $string = $strtolower ? strtolower($string) : $string;
  837.             return ($length AND is_numeric($length)) ? substr($string, 0, $length) : $string;
  838.         }
  839.         return false;
  840.     }
  843.     /**
  844.      * Convert a string to a valid file name.
  845.      *
  846.      * @param string $string The string to convert.
  847.      * @param integer|boolean $length Limit the length of the string?
  848.      *
  849.      * @return string|boolean The converted string.
  850.      */
  851.     public static function strToValidFilename($string=false, $length=200)
  852.     {
  853.         if (is_string($string))
  854.         {
  855.             $string_array = @explode('.', $string);
  856.             if (is_array($string_array) AND count($string_array))
  857.             {
  858.                 foreach($string_array AS $k => $s)
  859.                 {
  860.                         $string_array[$k] = ($ps = self::strToValidAlias($s)) ? $ps : '';
  861.                 }
  862.                 $string = @implode('.', $string_array);
  863.                 if ($length AND is_numeric($length))
  864.                 {
  865.                     if (($c=count($string_array))>1)
  866.                     {
  867.                         $ext = $string_array[$c-1];
  868.                         unset($string_array[$c-1]);
  869.                         $string = substr(@implode('.', $string_array), 0, (($nl=$length-(strlen($ext)+1))>0 ? $nl : 0)).'.'.$ext;
  870.                     }
  871.                     return substr($string, 0, $length);
  872.                 }
  873.                 return $string;
  874.             }
  875.         }
  876.         return false;
  877.     }
  880.     /**
  881.      * Get all style sheet file paths (even the combined)
  882.      *
  883.      * @return array The style sheet files.
  884.      */
  885.     public static function getStyleSheetFiles()
  886.     {
  887.         $cssFiles = array();
  889.         // new combiner
  890.         $objCombiner = new \Combiner();
  892.         // add the CSS framework style sheets
  893.         if (!empty($GLOBALS['TL_FRAMEWORK_CSS']) AND is_array($GLOBALS['TL_FRAMEWORK_CSS']))
  894.         {
  895.             foreach (array_unique($GLOBALS['TL_FRAMEWORK_CSS']) AS $stylesheet)
  896.             {
  897.                 if (!\Config::get('debugMode'))
  898.                 {
  899.                     $objCombiner->add($stylesheet);
  900.                 }
  901.                 else
  902.                 {
  903.                     $cssFiles[] = \Controller::addStaticUrlTo($stylesheet);
  904.                 }
  905.             }
  906.         }
  908.         // add the internal style sheets
  909.         if (!empty($GLOBALS['TL_CSS']) AND is_array($GLOBALS['TL_CSS']))
  910.         {
  911.             foreach (array_unique($GLOBALS['TL_CSS']) AS $stylesheet)
  912.             {
  913.                 $options = \String::resolveFlaggedUrl($stylesheet);
  915.                 if ($options->static AND !\Config::get('debugMode'))
  916.                 {
  917.                     $objCombiner->add($stylesheet, filemtime(TL_ROOT . '/' . $stylesheet), $options->media);
  918.                 }
  919.                 else
  920.                 {
  921.                     $cssFiles[] = \Controller::addStaticUrlTo($stylesheet);
  922.                 }
  923.             }
  924.         }
  926.         // add the user style sheets
  927.         if (!empty($GLOBALS['TL_USER_CSS']) AND is_array($GLOBALS['TL_USER_CSS']))
  928.         {
  929.             foreach (array_unique($GLOBALS['TL_USER_CSS']) AS $stylesheet)
  930.             {
  931.                 $options = \String::resolveFlaggedUrl($stylesheet);
  933.                 if ($options->static AND !\Config::get('debugMode'))
  934.                 {
  935.                     if ($options->mtime === null)
  936.                     {
  937.                         $options->mtime = filemtime(TL_ROOT . '/' . $stylesheet);
  938.                     }
  939.                     $objCombiner->add($stylesheet, $options->mtime, $options->media);
  940.                 }
  941.                 else
  942.                 {
  943.                     $cssFiles[] = \Controller::addStaticUrlTo($stylesheet);
  944.                 }
  945.             }
  946.         }
  948.         // get the aggregated style sheet file
  949.         if ($objCombiner->hasEntries())
  950.         {
  951.             $cssFiles[] = $objCombiner->getCombinedFile();
  952.         }
  954.         // return unique style sheet files
  955.         return array_unique($cssFiles);
  956.     }
  958.     /**
  959.      * Get all inline css
  960.      *
  961.      * @return string The inline css.
  962.      */
  963.     public static function getInlineCSS()
  964.     {
  965.         $inlineCss = '';
  966.         foreach(self::getStyleSheetFiles() AS $cssFile)
  967.         {
  968.             if (file_exists(TL_ROOT.'/'.$cssFile))
  969.             {
  970.                 $inlineCss .= file_get_contents(TL_ROOT.'/'.$cssFile);
  971.             }
  972.         }
  973.         $inlineCss = trim($inlineCss);
  974.         if (!empty($inlineCss))
  975.         {
  976.             $inlineCss = '<style>'.$inlineCss.'</style>';
  977.         }
  979.         return $inlineCss;
  980.     }
  981. }