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/cms/console/ThemeInstall.php

@@ -0,0 +1,130 @@
+<?php namespace Cms\Console;
+
+use Cms\Classes\Theme;
+use Cms\Classes\ThemeManager;
+use File;
+use System\Classes\UpdateManager;
+use Winter\Storm\Console\Command;
+
+/**
+ * Console command to install a new theme.
+ *
+ * This adds a new theme by requesting it from the Winter marketplace.
+ *
+ * @package winter\wn-cms-module
+ * @author Alexey Bobkov, Samuel Georges
+ */
+class ThemeInstall extends Command
+{
+    /**
+     * The console command name.
+     * @var string
+     */
+    protected $name = 'theme:install';
+
+    /**
+     * @var string The name and signature of this command.
+     */
+    protected $signature = 'theme:install
+        {name : The name of the theme. <info>(eg: AuthorName.ThemeName)</info>}
+        {dirName? : Destination directory name for the theme installation.}
+    ';
+
+    /**
+     * The console command description.
+     * @var string
+     */
+    protected $description = 'Install a theme from the Winter marketplace.';
+
+    /**
+     * Execute the console command.
+     * @return void
+     */
+    public function handle()
+    {
+        $themeName = $this->argument('name');
+        $argDirName = $this->argument('dirName');
+
+        if ($argDirName && $themeName == $argDirName) {
+            $argDirName = null;
+        }
+
+        if ($argDirName) {
+            if (!Theme::isValidDirName($argDirName)) {
+                return $this->error('Invalid destination directory name.');
+            }
+
+            if (Theme::exists($argDirName)) {
+                return $this->error(sprintf('A theme named %s already exists.', $argDirName));
+            }
+        }
+
+        try {
+            $themeManager = ThemeManager::instance();
+            $updateManager = UpdateManager::instance();
+
+            $themeDetails = $updateManager->requestThemeDetails($themeName);
+
+            if ($themeManager->isInstalled($themeDetails['code'])) {
+                return $this->error(sprintf('The theme %s is already installed.', $themeDetails['code']));
+            }
+
+            if (Theme::exists($themeDetails['code'])) {
+                return $this->error(sprintf('A theme named %s already exists.', $themeDetails['code']));
+            }
+
+            $fields = ['Name', 'Description', 'Author', 'URL', ''];
+
+            $this->info(sprintf(
+                implode(': %s'.PHP_EOL, $fields),
+                $themeDetails['code'],
+                $themeDetails['description'],
+                $themeDetails['author'],
+                $themeDetails['product_url']
+            ));
+
+            if (!$this->confirm('Do you wish to continue? [Y|n]', true)) {
+                return;
+            }
+
+            $this->info('Downloading theme...');
+            $updateManager->downloadTheme($themeDetails['code'], $themeDetails['hash']);
+
+            $this->info('Extracting theme...');
+            $updateManager->extractTheme($themeDetails['code'], $themeDetails['hash']);
+
+            $dirName = $this->themeCodeToDir($themeDetails['code']);
+
+            if ($argDirName) {
+                /*
+                 * Move downloaded theme to a new directory.
+                 * Basically we're renaming it.
+                 */
+                File::move(themes_path().'/'.$dirName, themes_path().'/'.$argDirName);
+
+                /*
+                 * Let's make sure to unflag the 'old' theme as
+                 * installed so it can be re-installed later.
+                 */
+                $themeManager->setUninstalled($themeDetails['code']);
+
+                $dirName = $argDirName;
+            }
+
+            $this->info(sprintf('The theme %s has been installed. (now %s)', $themeDetails['code'], $dirName));
+        } catch (\Throwable $ex) {
+            $this->error($ex->getMessage());
+        }
+    }
+
+    /**
+     * Theme code to dir.
+     *
+     * @param string $themeCode
+     * @return string
+     */
+    protected function themeCodeToDir($themeCode)
+    {
+        return strtolower(str_replace('.', '-', $themeCode));
+    }
+}