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/backend/models/ExportModel.php

@@ -0,0 +1,206 @@
+<?php namespace Backend\Models;
+
+use File;
+use Lang;
+use Model;
+use Response;
+use League\Csv\Writer as CsvWriter;
+use League\Csv\EscapeFormula as CsvEscapeFormula;
+use ApplicationException;
+use SplTempFileObject;
+
+/**
+ * Model used for exporting data
+ *
+ * @package winter\wn-backend-module
+ * @author Alexey Bobkov, Samuel Georges
+ */
+abstract class ExportModel extends Model
+{
+    /**
+     * Called when data is being exported.
+     * The return value should be an array in the format of:
+     *
+     *   [
+     *       'db_name1' => 'Some attribute value',
+     *       'db_name2' => 'Another attribute value'
+     *   ],
+     *   [...]
+     *
+     */
+    abstract public function exportData($columns, $sessionKey = null);
+
+    /**
+     * Export data based on column names and labels.
+     * The $columns array should be in the format of:
+     *
+     *   [
+     *       'db_name1' => 'Column label',
+     *       'db_name2' => 'Another label',
+     *       ...
+     *   ]
+     *
+     */
+    public function export($columns, $options)
+    {
+        $sessionKey = array_get($options, 'sessionKey');
+        $data = $this->exportData(array_keys($columns), $sessionKey);
+        return $this->processExportData($columns, $data, $options);
+    }
+
+    /**
+     * Download a previously compiled export file.
+     * @return void
+     */
+    public function download($name, $outputName = null)
+    {
+        if (!preg_match('/^oc[0-9a-z]*$/i', $name)) {
+            throw new ApplicationException(Lang::get('backend::lang.import_export.file_not_found_error'));
+        }
+
+        $csvPath = temp_path() . '/' . $name;
+        if (!file_exists($csvPath)) {
+            throw new ApplicationException(Lang::get('backend::lang.import_export.file_not_found_error'));
+        }
+
+        return Response::download($csvPath, $outputName, ['Content-Type' => 'text/csv'])->deleteFileAfterSend(true);
+    }
+
+    /**
+     * Converts a data collection to a CSV file.
+     */
+    protected function processExportData($columns, $results, $options)
+    {
+        /*
+         * Validate
+         */
+        if (!$results) {
+            throw new ApplicationException(Lang::get('backend::lang.import_export.empty_error'));
+        }
+
+        /*
+         * Parse options
+         */
+        $defaultOptions = [
+            'firstRowTitles' => true,
+            'useOutput' => false,
+            'fileName' => 'export.csv',
+            'delimiter' => null,
+            'enclosure' => null,
+            'escape' => null
+        ];
+
+        $options = array_merge($defaultOptions, $options);
+        $columns = $this->exportExtendColumns($columns);
+
+        /*
+         * Prepare CSV
+         */
+        $csv = CsvWriter::createFromFileObject(new SplTempFileObject);
+
+        $csv->setOutputBOM(CsvWriter::BOM_UTF8);
+
+        if ($options['delimiter'] !== null) {
+            $csv->setDelimiter($options['delimiter']);
+        }
+
+        if ($options['enclosure'] !== null) {
+            $csv->setEnclosure($options['enclosure']);
+        }
+
+        if ($options['escape'] !== null) {
+            $csv->setEscape($options['escape']);
+        }
+
+        $csv->addFormatter(new CsvEscapeFormula());
+
+        /*
+         * Add headers
+         */
+        if ($options['firstRowTitles']) {
+            $headers = $this->getColumnHeaders($columns);
+            $csv->insertOne($headers);
+        }
+
+        /*
+         * Add records
+         */
+        foreach ($results as $result) {
+            $data = $this->matchDataToColumns($result, $columns);
+            $csv->insertOne($data);
+        }
+
+        /*
+         * Output
+         */
+        if ($options['useOutput']) {
+            $csv->output($options['fileName']);
+        }
+
+        /*
+         * Save for download
+         */
+        $csvName = uniqid('oc');
+        $csvPath = temp_path().'/'.$csvName;
+        $output = $csv->__toString();
+
+        File::put($csvPath, $output);
+
+        return $csvName;
+    }
+
+    /**
+     * Used to override column definitions at export time.
+     */
+    protected function exportExtendColumns($columns)
+    {
+        return $columns;
+    }
+
+    /**
+     * Extracts the headers from the column definitions.
+     */
+    protected function getColumnHeaders($columns)
+    {
+        $headers = [];
+
+        foreach ($columns as $column => $label) {
+            $headers[] = Lang::get($label);
+        }
+
+        return $headers;
+    }
+
+    /**
+     * Ensures the correct order of the column data.
+     */
+    protected function matchDataToColumns($data, $columns)
+    {
+        $results = [];
+
+        foreach ($columns as $column => $label) {
+            $results[] = array_get($data, $column);
+        }
+
+        return $results;
+    }
+
+    /**
+     * Implodes a single dimension array using pipes (|)
+     * Multi dimensional arrays are not allowed.
+     * @return string
+     */
+    protected function encodeArrayValue($data, $delimeter = '|')
+    {
+        $newData = [];
+        foreach ($data as $value) {
+            if (is_array($value)) {
+                $newData[] = 'Array';
+            } else {
+                $newData[] = str_replace($delimeter, '\\'.$delimeter, $value);
+            }
+        }
+
+        return implode($delimeter, $newData);
+    }
+}