feat: VivesPOS landing on Winter CMS 1.2 — theme + plugin + Dockerfile

- Base: wintercms/winter branch 1.2 (full framework)
- Theme vivespos: Canvas 7 + Bootstrap 5 CDN, custom CSS
- Layout: deferred GTM/GA4 tracking, JSON-LD SoftwareApplication
- Partials: hero (offline-first), features, modes (offline/nube toggle),
  screenshots, pricing (3 planes), comparison, FAQ, CTA
- Plugin VivesPOS.Site with ContactForm
- Dockerfile: PHP 8.2 Apache, port 80, healthcheck
- Added winter/wn-pages, blog, sitemap, seo plugins
- Active theme set to vivespos

modules/system/traits/ConfigMaker.php

@@ -0,0 +1,212 @@
+<?php namespace System\Traits;
+
+use Yaml;
+use File;
+use Lang;
+use Event;
+use SystemException;
+use stdClass;
+use Config;
+
+/**
+ * Config Maker Trait
+ * Adds configuration based methods to a class
+ *
+ * @package winter\wn-system-module
+ * @author Alexey Bobkov, Samuel Georges
+ */
+trait ConfigMaker
+{
+
+    /**
+     * @var string Specifies a path to the config directory.
+     */
+    protected $configPath;
+
+    /**
+     * Reads the contents of the supplied file and applies it to this object.
+     * @param array $configFile
+     * @param array $requiredConfig
+     * @return array|stdClass
+     */
+    public function makeConfig($configFile = [], $requiredConfig = [])
+    {
+        if (!$configFile) {
+            $configFile = [];
+        }
+
+        /*
+         * Config already made
+         */
+        if (is_object($configFile)) {
+            $config = $configFile;
+        }
+        /*
+         * Embedded config
+         */
+        elseif (is_array($configFile)) {
+            $config = $this->makeConfigFromArray($configFile);
+        }
+        /*
+         * Process config from file contents
+         */
+        else {
+            if (isset($this->controller) && method_exists($this->controller, 'getConfigPath')) {
+                $configFile = $this->controller->getConfigPath($configFile);
+            }
+            else {
+                $configFile = $this->getConfigPath($configFile);
+            }
+
+            if (!File::isFile($configFile)) {
+                throw new SystemException(Lang::get(
+                    'system::lang.config.not_found',
+                    ['file' => $configFile, 'location' => get_called_class()]
+                ));
+            }
+
+            $config = Yaml::parseFile($configFile);
+
+            /**
+             * @event system.extendConfigFile
+             * Provides an opportunity to modify config files
+             *
+             * Example usage:
+             *
+             *     Event::listen('system.extendConfigFile', function ((string) $path, (array) $config) {
+             *         if ($path === '/plugins/author/plugin-name/controllers/mycontroller/config_relation.yaml') {
+             *             unset($config['property_value']['view']['recordUrl']);
+             *             return $config;
+             *         }
+             *     });
+             *
+             */
+            $publicFile = File::localToPublic($configFile);
+            if ($results = Event::fire('system.extendConfigFile', [$publicFile, $config])) {
+                foreach ($results as $result) {
+                    if (!is_array($result)) {
+                        continue;
+                    }
+                    $config = array_merge($config, $result);
+                }
+            }
+
+            $config = $this->makeConfigFromArray($config);
+        }
+
+        /*
+         * Validate required configuration
+         */
+        foreach ($requiredConfig as $property) {
+            if (!property_exists($config, $property)) {
+                throw new SystemException(Lang::get(
+                    'system::lang.config.required',
+                    ['property' => $property, 'location' => get_called_class()]
+                ));
+            }
+        }
+
+        return $config;
+    }
+
+    /**
+     * Makes a config object from an array, making the first level keys properties of a new object.
+     *
+     * @param array $configArray Config array.
+     * @return stdClass The config object
+     */
+    public function makeConfigFromArray($configArray = [])
+    {
+        $object = new stdClass;
+
+        if (!is_array($configArray)) {
+            return $object;
+        }
+
+        foreach ($configArray as $name => $value) {
+            $object->{$name} = $value;
+        }
+
+        return $object;
+    }
+
+    /**
+     * Locates a file based on it's definition. If the file starts with
+     * the ~ symbol it will be returned in context of the application base path,
+     * otherwise it will be returned in context of the config path.
+     * @param string $fileName File to load.
+     * @param mixed $configPath Explicitly define a config path.
+     * @return string Full path to the config file.
+     */
+    public function getConfigPath($fileName, $configPath = null)
+    {
+        if (!isset($this->configPath)) {
+            $this->configPath = $this->guessConfigPath();
+        }
+
+        if (!$configPath) {
+            $configPath = $this->configPath;
+        }
+
+        $fileName = File::symbolizePath($fileName);
+
+        if (File::isLocalPath($fileName) ||
+            (!Config::get('cms.restrictBaseDir', true) && realpath($fileName) !== false)
+        ) {
+            return $fileName;
+        }
+
+        if (!is_array($configPath)) {
+            $configPath = [$configPath];
+        }
+
+        foreach ($configPath as $path) {
+            $_fileName = $path . '/' . $fileName;
+            if (File::isFile($_fileName)) {
+                return $_fileName;
+            }
+        }
+
+        return $fileName;
+    }
+
+    /**
+     * Guess the package path for the called class.
+     * @param string $suffix An extra path to attach to the end
+     * @return string
+     */
+    public function guessConfigPath($suffix = '')
+    {
+        $class = get_called_class();
+        return $this->guessConfigPathFrom($class, $suffix);
+    }
+
+    /**
+     * Guess the package path from a specified class.
+     * @param string $class Class to guess path from.
+     * @param string $suffix An extra path to attach to the end
+     * @return string
+     */
+    public function guessConfigPathFrom($class, $suffix = '')
+    {
+        $classFolder = strtolower(class_basename($class));
+        $classFile = realpath(dirname(File::fromClass($class)));
+        return $classFile ? $classFile . '/' . $classFolder . $suffix : null;
+    }
+
+    /**
+     * Merges two configuration sources, either prepared or not, and returns
+     * them as a single configuration object.
+     * @param mixed $configA
+     * @param mixed $configB
+     * @return stdClass The config object
+     */
+    public function mergeConfig($configA, $configB)
+    {
+        $configA = $this->makeConfig($configA);
+
+        $configB = $this->makeConfig($configB);
+
+        return (object) array_merge((array) $configA, (array) $configB);
+    }
+}