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/traits/FormModelWidget.php

@@ -0,0 +1,98 @@
+<?php
+
+namespace Backend\Traits;
+
+use Exception;
+use Illuminate\Support\Facades\Lang;
+use Winter\Storm\Database\Model;
+use Winter\Storm\Database\Relations\Relation;
+use Winter\Storm\Exception\ApplicationException;
+
+/**
+ * Form Model Widget Trait
+ *
+ * Special logic for for form widgets that use a database stored model.
+ *
+ * @package winter\wn-backend-module
+ * @author Alexey Bobkov, Samuel Georges
+ */
+trait FormModelWidget
+{
+    /**
+     * Returns the final model and attribute name of a nested HTML array attribute.
+     * Eg: list($model, $attribute) = $this->resolveModelAttribute($this->valueFrom);
+     * @throws ApplicationException if something goes wrong when attempting to resolve the model attribute
+     */
+    public function resolveModelAttribute(string $attribute): array
+    {
+        try {
+            return $this->formField->resolveModelAttribute($this->model, $attribute);
+        }
+        catch (Exception $ex) {
+            throw new ApplicationException(Lang::get('backend::lang.model.missing_relation', [
+                'class' => get_class($this->model),
+                'relation' => $attribute
+            ]));
+        }
+    }
+
+    /**
+     * Returns the model of a relation type, supports nesting via HTML array.
+     * @throws ApplicationException if the related model cannot be resolved
+     */
+    public function getRelationModel(): Model
+    {
+        list($model, $attribute) = $this->resolveModelAttribute($this->valueFrom);
+
+        if (!$model) {
+            throw new ApplicationException(Lang::get('backend::lang.model.missing_relation', [
+                'class' => get_class($this->model),
+                'relation' => $this->valueFrom
+            ]));
+        }
+
+        if (!$model->hasRelation($attribute)) {
+            throw new ApplicationException(Lang::get('backend::lang.model.missing_relation', [
+                'class' => get_class($model),
+                'relation' => $attribute
+            ]));
+        }
+
+        return $model->makeRelation($attribute);
+    }
+
+    /**
+     * Returns the value as a relation object from the model, supports nesting via HTML array.
+     * @throws ApplicationException if the relationship cannot be resolved
+     * @return Relation
+     */
+    protected function getRelationObject()
+    {
+        list($model, $attribute) = $this->resolveModelAttribute($this->valueFrom);
+
+        if (!$model) {
+            throw new ApplicationException(Lang::get('backend::lang.model.missing_relation', [
+                'class' => get_class($this->model),
+                'relation' => $this->valueFrom
+            ]));
+        }
+
+        if (!$model->hasRelation($attribute)) {
+            throw new ApplicationException(Lang::get('backend::lang.model.missing_relation', [
+                'class' => get_class($model),
+                'relation' => $attribute
+            ]));
+        }
+
+        return $model->{$attribute}();
+    }
+
+    /**
+     * Returns the value as a relation type from the model, supports nesting via HTML array.
+     */
+    protected function getRelationType(): ?string
+    {
+        list($model, $attribute) = $this->resolveModelAttribute($this->valueFrom);
+        return $model->getRelationType($attribute);
+    }
+}