1: <?php
  2: /**
  3:  * CONTENIDO code generator abstract class
  4:  *
  5:  * @package Core
  6:  * @subpackage ContentType
  7:  * @version SVN Revision $Rev:$
  8:  *
  9:  * @author Murat Purc <murat@purc.de>
 10:  * @copyright four for business AG <www.4fb.de>
 11:  * @license http://www.contenido.org/license/LIZENZ.txt
 12:  * @link http://www.4fb.de
 13:  * @link http://www.contenido.org
 14:  */
 15: 
 16: defined('CON_FRAMEWORK') || die('Illegal call: Missing framework initialization - request aborted.');
 17: 
 18: /**
 19:  * CONTENIDO abstract code generator class.
 20:  *
 21:  * @package Core
 22:  * @subpackage ContentType
 23:  */
 24: abstract class cCodeGeneratorAbstract {
 25: 
 26:     /**
 27:      * CONTENIDO database instance
 28:      *
 29:      * @var cDb
 30:      */
 31:     protected $_db;
 32: 
 33:     /**
 34:      * Frontend debug options, see $frontend_debug in
 35:      * __FRONTEND_PATH__/data/config/config.php
 36:      *
 37:      * @var array
 38:      */
 39:     protected $_feDebugOptions = array();
 40: 
 41:     /**
 42:      * Collected CSS data for current template
 43:      *
 44:      * @var string
 45:      */
 46:     protected $_cssData = '';
 47: 
 48:     /**
 49:      * Collected JS data for current template
 50:      *
 51:      * @var string
 52:      */
 53:     protected $_jsData = '';
 54: 
 55:     /**
 56:      * Template name
 57:      *
 58:      * @var string
 59:      */
 60:     protected $_tplName = '';
 61: 
 62:     /**
 63:      * Category id
 64:      *
 65:      * @var int
 66:      */
 67:     protected $_idcat;
 68: 
 69:     /**
 70:      * Article id
 71:      *
 72:      * @var int
 73:      */
 74:     protected $_idart;
 75: 
 76:     /**
 77:      * Language id
 78:      *
 79:      * @var int
 80:      */
 81:     protected $_lang;
 82: 
 83:     /**
 84:      * Client id
 85:      *
 86:      * @var int
 87:      */
 88:     protected $_client;
 89: 
 90:     /**
 91:      * Flag to process layout
 92:      *
 93:      * @var bool
 94:      */
 95:     protected $_layout;
 96: 
 97:     /**
 98:      * Flag to persist generated code
 99:      *
100:      * @var bool
101:      */
102:     protected $_save;
103: 
104:     /**
105:      * Article language id
106:      *
107:      * @var int
108:      */
109:     protected $_idartlang;
110: 
111:     /**
112:      * Page title (generally from article language table)
113:      *
114:      * @var string
115:      */
116:     protected $_pageTitle;
117: 
118:     /**
119:      * Layout code.
120:      * Initially with container tags which will be replaced against module
121:      * outputs.
122:      *
123:      * @var string
124:      */
125:     protected $_layoutCode = '';
126: 
127:     /**
128:      * Module output code prefix
129:      *
130:      * @var array
131:      */
132:     protected $_modulePrefix = array();
133: 
134:     /**
135:      * Module output code
136:      *
137:      * @var string
138:      */
139:     protected $_moduleCode = '';
140: 
141:     /**
142:      * Module output code suffix
143:      *
144:      * @var array
145:      */
146:     protected $_moduleSuffix = array();
147: 
148:     /**
149:      * Module output code suffix
150:      *
151:      * @var cApiArticleLanguage
152:      */
153:     protected $_oArtLang;
154: 
155:     /**
156:      */
157:     public function __construct() {
158:         $this->_db = cRegistry::getDb();
159:     }
160: 
161:     /**
162:      * Setter for frontend debug options (see $frontend_debug in
163:      * __FRONTEND_PATH__/data/config/config.php
164:      * located in clients frontend directory)
165:      *
166:      * @param bool $debug
167:      */
168:     public function setFrontendDebugOptions(array $debugOptions) {
169:         $this->_feDebugOptions = $debugOptions;
170:     }
171: 
172:     /**
173:      * Generates the code for a specific article (article for a client in a
174:      * language).
175:      *
176:      * @param int $idcat
177:      * @param int $idart
178:      * @param int $lang
179:      * @param int $client
180:      * @param bool $layout
181:      * @param bool $save Flag to persist generated code
182:      * @param bool $contype Flag to enable/disable replacement of CMS_TAGS[]
183:      *
184:      * @throws cInvalidArgumentException if an article with the given idart and
185:      *         idlang can not be loaded
186:      * @return string Generated code or error code '0601' if no template
187:      *         configuration was found for category or article.
188:      */
189:     public function generate($idcat, $idart, $lang, $client, $layout = false, $save = true, $contype = true) {
190:         $this->_idcat = (int) $idcat;
191:         $this->_idart = (int) $idart;
192:         $this->_lang = (int) $lang;
193:         $this->_client = (int) $client;
194:         $this->_layout = (bool) $layout;
195:         $this->_save = (bool) $save;
196: 
197:         $this->_oArtLang = new cApiArticleLanguage();
198:         $this->_oArtLang->loadByArticleAndLanguageId($idart, $lang);
199:         if (!$this->_oArtLang->isLoaded()) {
200:             throw new cInvalidArgumentException('Couldn\'t load article language for idart=' . $idart . 'AND idlang=' . $lang);
201:         }
202: 
203:         $this->_idartlang = $this->_oArtLang->get('idartlang');
204:         $this->_pageTitle = stripslashes($this->_oArtLang->get('pagetitle'));
205: 
206:         return $this->_generate($contype);
207:     }
208: 
209:     /**
210:      * Generates the code for a specific article (article for a client in a
211:      * language).
212:      *
213:      * @param bool $contype Flag to enable/disable replacement of CMS_TAGS[]
214:      * @return string The generated code
215:      */
216:     abstract function _generate($contype = true);
217: 
218:     /**
219:      * Returns the template configuration id, either by configured article or by
220:      * configured category.
221:      *
222:      * @return int|NULL
223:      */
224:     protected function _getTemplateConfigurationId() {
225:         // Get configuration for article
226:         $idtplcfg = conGetTemplateConfigurationIdForArticle($this->_idart, $this->_idcat, $this->_lang, $this->_client);
227:         if (is_numeric($idtplcfg) && $idtplcfg != 0) {
228:             // Article is configured
229:             cDebug::out("configuration for article found: $idtplcfg<br><br>");
230:         } else {
231:             // Check whether category is configured
232:             $idtplcfg = conGetTemplateConfigurationIdForCategory($this->_idcat, $this->_lang, $this->_client);
233:             if (NULL !== $idtplcfg) {
234:                 // Category is configured
235:                 cDebug::out("configuration for category found: $idtplcfg<br><br>");
236:             }
237:         }
238: 
239:         return (is_numeric($idtplcfg)) ? $idtplcfg : NULL;
240:     }
241: 
242:     /**
243:      *
244:      * @param int $idcatart
245:      */
246:     abstract protected function _processNoConfigurationError($idcatart);
247: 
248:     /**
249:      * Returns array containing used layout, template and template name
250:      *
251:      * @global array $cfg
252:      * @return array Asooziative array like array('idlay' => (int), 'idtpl' =>
253:      *         (int), 'name' => (string))
254:      */
255:     protected function _getTemplateData() {
256:         global $cfg;
257: 
258:         // Get IDLAY and IDMOD array
259:         $sql = "SELECT
260:                     a.idlay AS idlay
261:                     , a.idtpl AS idtpl
262:                     , a.name AS name
263:                 FROM
264:                     `%s` AS a
265:                     , `%s` AS b
266:                 WHERE
267:                     b.idtplcfg = %d
268:                     AND b.idtpl = a.idtpl
269:                 ;";
270: 
271:         $sql = $this->_db->prepare($sql, $cfg['tab']['tpl'], $cfg['tab']['tpl_conf'], $this->_idtplcfg);
272:         $this->_db->query($sql);
273:         $this->_db->nextRecord();
274:         $data = $this->_db->toArray();
275: 
276:         if ($this->_layout !== false) {
277:             $data['idlay'] = $this->_layout;
278:         }
279: 
280:         cDebug::out("Using Layout: $data[idlay] and Template: $data[idtpl] for generation of code.<br><br>");
281: 
282:         return $data;
283:     }
284: 
285:     /**
286:      * Processes replacements of all existing CMS_...
287:      * tags within passed code
288:      *
289:      * @param array $contentList Assoziative list of CMS variables
290:      * @param bool $saveKeywords Flag to save collected keywords during
291:      *        replacement process.
292:      */
293:     protected function _processCmsTags($contentList, $saveKeywords = true) {
294:         // #####################################################################
295:         // NOTE: Variables below are required in included/evaluated content type
296:         // codes!
297:         global $db, $db2, $sess, $cfg, $code, $cfgClient, $encoding;
298: 
299:         // NOTE: Variables below are additionally required in included/evaluated
300:         // content type codes within backend edit mode!
301:         global $edit, $editLink, $belang;
302: 
303:         $idcat = $this->_idcat;
304:         $idart = $this->_idart;
305:         $lang = $this->_lang;
306:         $client = $this->_client;
307:         $idartlang = $this->_idartlang;
308: 
309:         if (!is_object($db2)) {
310:             $db2 = cRegistry::getDb();
311:         }
312:         // End: Variables required in content type codes
313:         // #####################################################################
314: 
315:         $match = array();
316:         $keycode = array();
317: 
318:         // NOTE: $a_content is used by included/evaluated content type codes
319:         // below
320:         $a_content = $contentList;
321: 
322:         // Select all cms_type entries
323:         $_typeList = array();
324:         $oTypeColl = new cApiTypeCollection();
325:         $oTypeColl->select();
326:         while ($oType = $oTypeColl->next()) {
327:             $_typeList[] = $oType->toObject();
328:         }
329: 
330:         // Replace all CMS_TAGS[]
331:         foreach ($_typeList as $_typeItem) {
332:             $key = strtolower($_typeItem->type);
333: 
334:             $type = $_typeItem->type;
335:             // Try to find all CMS_{type}[{number}] values, e. g. CMS_HTML[1]
336:             // $tmp = preg_match_all('/(' . $type . ')\[+([a-z0-9_]+)+\]/i',
337:             // $this->_layoutCode, $match);
338:             $tmp = preg_match_all('/(' . $type . '\[+(\d)+\])/i', $this->_layoutCode, $match);
339: 
340:             $a_[$key] = $match[0];
341: 
342:             $success = array_walk($a_[$key], 'extractNumber');
343: 
344:             $search = array();
345:             $replacements = array();
346: 
347:             $typeClassName = $this->_getContentTypeClassName($type);
348:             $typeCodeFile = $this->_getContentTypeCodeFilePathName($type);
349: 
350:             foreach ($a_[$key] as $val) {
351:                 if (class_exists($typeClassName)) {
352:                     // We have a class for the content type, use it
353:                     $tmp = $a_content[$_typeItem->type][$val];
354:                     $cTypeObject = new $typeClassName($tmp, $val, $a_content);
355:                     if (cRegistry::isBackendEditMode()) {
356:                         $tmp = $cTypeObject->generateEditCode();
357:                     } else {
358:                         $tmp = $cTypeObject->generateViewCode();
359:                     }
360:                 } else if (cFileHandler::exists($typeCodeFile)) {
361:                     // Include CMS type code file
362:                     include ($typeCodeFile);
363:                 }
364: 
365:                 $search[$val] = sprintf('%s[%s]', $type, $val);
366:                 $replacements[$val] = $tmp;
367:                 $keycode[$type][$val] = $tmp;
368:             }
369: 
370:             $this->_layoutCode = str_ireplace($search, $replacements, $this->_layoutCode);
371:         }
372:     }
373: 
374:     /**
375:      * Processes title tag in page code (layout)
376:      */
377:     abstract protected function _processCodeTitleTag();
378: 
379:     /**
380:      * Processes all meta tags in page code (layout)
381:      */
382:     abstract protected function _processCodeMetaTags();
383: 
384:     /**
385:      * Replaces all container/module configuration tags (CMS_VALUE[n] values)
386:      * against their settings.
387:      *
388:      * @param int $containerId Container id
389:      * @param string $containerCfg A string being formatted like concatenated
390:      *        query
391:      *        parameter, e. g. param1=value1&param2=value2...
392:      *
393:      * @return string Concatenated PHP code containing CMS_VALUE variables and
394:      *         their values
395:      */
396:     protected function _processCmsValueTags($containerId, $containerCfg) {
397:         $containerCfgList = array();
398: 
399:         $containerCfg = preg_replace('/(&\$)/', '', $containerCfg);
400:         parse_str($containerCfg, $containerCfgList);
401:         /*
402:          * $tmp1 = preg_split('/&/', $containerCfg); foreach ($tmp1 as $key1 =>
403:          * $value1) { $tmp2 = explode('=', $value1); foreach ($tmp2 as $key2 =>
404:          * $value2) { $containerCfgList["$tmp2[0]"] = $tmp2[1]; } }
405:          */
406: 
407:         $CiCMS_Var = '$C' . $containerId . 'CMS_VALUE';
408:         $CiCMS_Values = array();
409: 
410:         foreach ($containerCfgList as $key3 => $value3) {
411:             $tmp = $value3;
412:             $tmp = str_replace("\'", "'", $tmp);
413:             $CiCMS_Values[] = $CiCMS_Var . '[' . $key3 . '] = "' . $tmp . '"; ';
414:             $this->_moduleCode = str_replace("\$CMS_VALUE[$key3]", $tmp, $this->_moduleCode);
415:             $this->_moduleCode = str_replace("CMS_VALUE[$key3]", $tmp, $this->_moduleCode);
416:         }
417: 
418:         $this->_moduleCode = str_replace("CMS_VALUE", $CiCMS_Var, $this->_moduleCode);
419:         $this->_moduleCode = str_replace("\$" . $CiCMS_Var, $CiCMS_Var, $this->_moduleCode);
420:         $this->_moduleCode = preg_replace("/(CMS_VALUE\[)([0-9]*)(\])/i", '', $this->_moduleCode);
421: 
422:         return implode("\n", $CiCMS_Values);
423:     }
424: 
425:     /**
426:      * Extends container code by adding several debug features, if enabled and
427:      * configured.
428:      *
429:      * @param int $containerId Container id
430:      * @param array $module Recordset as assoziative array of related module
431:      *        (container code)
432:      */
433:     protected function _processFrontendDebug($containerId, array $module) {
434:         global $containerinf;
435: 
436:         $data = $this->_getTemplateData();
437: 
438:         if (empty($this->_feDebugOptions)) {
439:             return;
440:         }
441: 
442:         $sFeDebug = '';
443:         if ($this->_feDebugOptions['container_display'] == true) {
444:             $this->_modulePrefix[] = 'if ($frontend_debug[\'container_display\']) echo "<!-- START CONTAINER ' . $containerinf[$data['idlay']][$containerId]['name'] . ' (' . $containerId . ') -->";';
445:         }
446: 
447:         if ($this->_feDebugOptions['module_display'] == true) {
448:             $this->_modulePrefix[] = 'if ($frontend_debug[\'module_display\']) echo "<!-- START MODULE ' . $module['name'] . ' (' . $module['idmod'] . ') -->";';
449:         }
450: 
451:         if ($this->_feDebugOptions['module_timing'] == true) {
452:             $this->_modulePrefix[] = '$modTime' . $containerId . ' = -getmicrotime(true);';
453:             $this->_moduleSuffix[] = '$modTime' . $containerId . ' += getmicrotime(true);';
454:         }
455: 
456:         if ($this->_feDebugOptions['module_display'] == true) {
457:             $this->_moduleSuffix[] = 'if ($frontend_debug[\'module_display\']) echo "<!-- END MODULE ' . $module['name'] . ' (' . $module['idmod'] . ')";';
458:             if ($this->_feDebugOptions['module_timing'] == true) {
459:                 $this->_moduleSuffix[] = 'if ($frontend_debug[\'module_timing\']) echo(" AFTER " . $modTime' . $containerId . ');';
460:             }
461:             $this->_moduleSuffix[] = 'if ($frontend_debug[\'module_display\']) echo " -->";';
462:         }
463:         if ($this->_feDebugOptions['container_display'] == true) {
464:             $this->_moduleSuffix[] = 'if ($frontend_debug[\'container_display\']) echo "<!-- END CONTAINER ' . $containerinf[$data['idlay']][$containerId]['name'] . ' (' . $containerId . ') -->";';
465:         }
466:     }
467: 
468:     /**
469:      * Replaces container tag in layout against the parsed container code
470:      * (module code).
471:      *
472:      * @param int $containerId Container id
473:      */
474:     protected function _processCmsContainer($containerId) {
475:         $cmsContainer = "CMS_CONTAINER[$containerId]";
476: 
477:         // Replace new container (<container id="n"..>) against old one
478:         // (CMS_CONTAINER[n])
479:         $this->_layoutCode = preg_replace("/<container( +)id=\\\"$containerId\\\"(.*)>(.*)<\/container>/Uis", $cmsContainer, $this->_layoutCode);
480:         $this->_layoutCode = preg_replace("/<container( +)id=\\\"$containerId\\\"(.*)\/>/i", $cmsContainer, $this->_layoutCode);
481: 
482:         // Concatenate final container/module output code, but generate PHP code
483:         // only
484:         // if there is something to generate
485:         $modulePrefix = trim(implode("\n", $this->_modulePrefix));
486:         if (!empty($modulePrefix)) {
487:             $modulePrefix = "<?php\n" . $modulePrefix . "\n?>";
488:         }
489:         $moduleSuffix = trim(implode("\n", $this->_moduleSuffix));
490:         if (!empty($moduleSuffix)) {
491:             $moduleSuffix = "<?php\n" . $moduleSuffix . "\n?>";
492:         }
493:         $moduleOutput = $modulePrefix . $this->_moduleCode . $moduleSuffix;
494: 
495:         // Replace container (CMS_CONTAINER[n]) against the container code
496:         $this->_layoutCode = str_ireplace($cmsContainer, $moduleOutput, $this->_layoutCode);
497:         // $this->_layoutCode = addslashes($this->_layoutCode);
498:     }
499: 
500:     /**
501:      * Returns array of all CMS_...
502:      * vars being used by current article and language
503:      *
504:      * @return array like $arr[type][typeid] = value;
505:      */
506:     protected function _getUsedCmsTypesData() {
507:         global $cfg;
508: 
509:         $return = array();
510: 
511:         // Find out what kind of CMS_... Vars are in use
512:         $sql = "SELECT * FROM `%s` AS A, `%s` AS B, `%s` AS C
513:                 WHERE A.idtype = C.idtype AND A.idartlang = B.idartlang AND B.idart = %d AND B.idlang = %d";
514:         $sql = $this->_db->prepare($sql, $cfg['tab']['content'], $cfg['tab']['art_lang'], $cfg['tab']['type'], $this->_idart, $this->_lang);
515:         $this->_db->query($sql);
516:         while ($this->_db->nextRecord()) {
517:             $return[$this->_db->f('type')][$this->_db->f('typeid')] = $this->_db->f('value');
518:         }
519: 
520:         return $return;
521:     }
522: 
523:     /**
524:      * Resets module related variables
525:      */
526:     protected function _resetModule() {
527:         $this->_modulePrefix = array();
528:         $this->_moduleCode = '';
529:         $this->_moduleSuffix = array();
530:     }
531: 
532:     /**
533:      * Returns the classname for a content type.
534:      *
535:      * @param string $type Content type, e. g. CMS_HTMLHEAD
536:      *
537:      * @return string The classname e. g. cContentTypeHtmlhead for content type
538:      *         CMS_HTMLHEAD
539:      */
540:     protected function _getContentTypeClassName($type) {
541:         $typeClassName = 'cContentType' . ucfirst(strtolower(str_replace('CMS_', '', $type)));
542: 
543:         return $typeClassName;
544:     }
545: 
546:     /**
547:      * Returns the full path to the include file name of a content type.
548:      *
549:      * @param string $type Content type, e. g. CMS_HTMLHEAD
550:      *
551:      * @return string The full path e. g.
552:      *         {path_to_contenido_includes}/type/code/include.CMS_HTMLHEAD.code.php
553:      *         for content type CMS_HTMLHEAD
554:      */
555:     protected function _getContentTypeCodeFilePathName($type) {
556:         global $cfg;
557:         $typeCodeFile = cRegistry::getBackendPath() . $cfg['path']['includes'] . 'type/code/include.' . $type . '.code.php';
558: 
559:         return $typeCodeFile;
560:     }
561: 
562:     /**
563:      *
564:      * @return cApiArticleLanguage the artlang object
565:      */
566:     protected function getArtLangObject() {
567:         return $this->_oArtLang;
568:     }
569: }
570: