new pisilinux web sites

2026-07-01 16:44:17 +03:00
commit b58488b586
21740 changed files with 2066209 additions and 0 deletions
@@ -0,0 +1,171 @@
+<?php namespace ZN\Inclusion;
+/**
+ * ZN PHP Web Framework
+ * 
+ * "Simplicity is the ultimate sophistication." ~ Da Vinci
+ * 
+ * @package ZN
+ * @license MIT [http://opensource.org/licenses/MIT]
+ * @author  Ozan UYKUN [ozan@znframework.com]
+ */
+
+use ZN\In;
+use ZN\Base;
+use ZN\Wizard;
+use ZN\Buffering;
+use ZN\Inclusion\Project\Theme;
+use ZN\Inclusion\Project\View as Views;
+
+class View
+{
+    /**
+     * Template Wizard Extension
+     * 
+     * @var string
+     */
+    protected static $templateWizardExtension = '.wizard';
+
+    /**
+     * Get container view
+     * 
+     * @param string $page
+     * @param array  $data          = NULL
+     * @param bool   $obGetContents = false
+     * 
+     * @return mixed
+     */
+    public static function container(string $page, ?array $data = NULL, bool $obGetContents = false)
+    {
+        return self::use($page, $data, $obGetContents, CONTAINER_PROJECT_DIR . 'Views/');
+    }
+
+    /**
+     * Get view
+     * @param string $page
+     * @param array  $data          = NULL
+     * @param bool   $obGetContents = false
+     * @param string $randomPageDir = VIEWS_DIR
+     * 
+     * @return mixed
+     */
+    public static function use(string $page, ?array $data = NULL, bool $obGetContents = false, string $randomPageDir = VIEWS_DIR)
+    {
+        # If the view starts with / symbol, it refers to pulling a file from 
+        # the view directory linked to the corresponding controller.
+        # 5.7.4[added]
+        if( isset($page[0]) && $page[0] === '/' )
+        {
+            $page = CURRENT_CONTROLLER . $page; // @codeCoverageIgnore
+        }
+        
+        if( ! empty(Properties::$parameters['usable']) )
+        {
+            $obGetContents = Properties::$parameters['usable'];
+        }
+
+        if( ! empty(Properties::$parameters['data']) )
+        {
+            $data = Properties::$parameters['data'];
+        }
+
+        Properties::$parameters = [];
+
+        if( ! empty($viewData = In::$view ) )
+        {
+            $inData = array_merge(...$viewData);
+        }
+        else
+        {
+            $inData = [];
+        }
+
+        $data = array_merge($inData, Views::$data, (array) $data);
+
+        if( is_file($randomPageDir . Base::suffix($page, '.php')) && ! strstr($page, self::$templateWizardExtension) )
+        {
+            return self::_page($page, $data, $obGetContents, $randomPageDir);
+        }
+
+        return self::_templateWizard(Base::suffix(Base::removeSuffix($page, '.php'), self::$templateWizardExtension), $data, $obGetContents, $randomPageDir);
+    }
+
+    /**
+     * Get view
+     * 
+     * @param string $page
+     * @param array  $data          = NULL
+     * @param bool   $obGetContents = false
+     * @param string $randomPageDir = VIEWS_DIR
+     * 
+     * @return mixed
+     */
+    protected static function _page($randomPageVariable, $randomDataVariable, $randomObGetContentsVariable = false, $randomPageDir = VIEWS_DIR, $randomIsWizard = NULL)
+    {
+        if( ! pathinfo($randomPageVariable, PATHINFO_EXTENSION) || stristr($randomPageVariable, self::$templateWizardExtension) )
+        {
+            $randomPageVariable = Base::suffix($randomPageVariable, '.php');
+        }
+
+        $randomPagePath = $randomPageDir . $randomPageVariable;
+        
+        if( ($active = Theme::$active) !== NULL )
+        {
+            $activeRandomPagePath = $randomPageDir . $active . $randomPageVariable;
+
+            if( is_file($activeRandomPagePath) )
+            {
+                $randomPagePath = $activeRandomPagePath; // @codeCoverageIgnore
+            }
+        }  
+
+        if( $randomIsWizard === true )
+        {
+            Wizard::isolation($randomPagePath);
+        }
+        
+        if( is_file($randomPagePath) )
+        {
+            $return = Buffering::file($randomPagePath, $randomDataVariable);
+            
+            if( $active !== NULL )
+            {
+                Theme::integration($active, $return);
+            }
+
+            if( $randomObGetContentsVariable === false )
+            {
+                echo $return; return; // @codeCoverageIgnore
+            }
+            else
+            {
+                return $return;
+            }
+        }
+        else
+        {
+            return false;
+        }
+    }
+
+    /**
+     * Get view
+     * 
+     * @param string $page
+     * @param array  $data          = NULL
+     * @param bool   $obGetContents = false
+     * @param string $randomPageDir = PAGES_DIR
+     * 
+     * @return void|mixed
+     */
+    protected static function _templateWizard($page, $data, $obGetContents, $randomPageDir = PAGES_DIR)
+    {
+        $return = Wizard::data(self::_page($page, $data, true, $randomPageDir, true), (array) $data);
+
+        if( $obGetContents === true )
+        {
+            return $return;
+        }
+
+        echo $return;
+    }
+}