fix(webservice): Polished code

redundant require statements, clean up install trait, standardize trait names, remove hard-coded php version require for composer.json

classes/WebserviceSpecificManagementOrderreference.php

@@ -0,0 +1,80 @@
+<?php
+// You can do api/order_reference?id_order=12 or api/order_reference?id_cart=12
+
+class WebserviceSpecificManagementOrderreference implements WebserviceSpecificManagementInterface
+{
+    private $objectOutput;
+    private $wsObject;
+    private ?array $result = null;
+
+    public function setObjectOutput(WebserviceOutputBuilder $objectOutput)
+    {
+        $this->objectOutput = $objectOutput;
+        return $this;
+    }
+
+    public function getObjectOutput()
+    {
+        return $this->objectOutput;
+    }
+
+    public function setWsObject(WebserviceRequest $wsObject)
+    {
+        $this->wsObject = $wsObject;
+        return $this;
+    }
+
+    public function getWsObject()
+    {
+        return $this->wsObject;
+    }
+
+    public function manage()
+    {
+        $fragments = $this->wsObject ? $this->wsObject->urlFragments : [];
+
+        if (isset($fragments['id_order'])) {
+            $this->result = $this->fetchByOrderId((int) $fragments['id_order']);
+        } elseif (isset($fragments['id_cart'])) {
+            $this->result = $this->fetchByCartId((int) $fragments['id_cart']);
+        }
+
+        return true;
+    }
+
+    private function fetchByCartId(int $cartId): ?array
+    {
+        $row = Db::getInstance()->getRow(
+            'SELECT id, id_cart, order_reference FROM ' . _DB_PREFIX_ . 'order_reference WHERE id_cart = ' . (int) $cartId
+        );
+
+        return $row ?: null;
+    }
+
+    private function fetchByOrderId(int $orderId): ?array
+    {
+        $idCart = Db::getInstance()->getValue(
+            'SELECT id_cart FROM ' . _DB_PREFIX_ . 'orders WHERE id_order = ' . (int) $orderId
+        );
+
+        if ($idCart) {
+            return $this->fetchByCartId((int) $idCart);
+        }
+
+        return null;
+    }
+
+    public function getContent()
+    {
+        $xml = new SimpleXMLElement('<order_references/>');
+
+        if ($this->result !== null) {
+            $node = $xml->addChild('order_reference');
+            $node->addChild('id', (string) $this->result['id']);
+            $node->addChild('id_cart', (string) $this->result['id_cart']);
+            $node->addChild('reference', htmlspecialchars($this->result['order_reference']));
+        }
+
+        return $xml->asXML();
+    }
+}

classes/config/services.yml

@@ -0,0 +1,18 @@
+services:
+    _defaults:
+        autowire: true
+        autoconfigure: true
+
+    # Repository - this makes it available via dependency injection
+    Module\WsOrderreference\Repository\OrderReferenceRepository:
+        public: true
+        factory: ["@doctrine.orm.default_entity_manager", getRepository]
+        arguments:
+            - Module\WsOrderreference\Entity\OrderReference
+
+    # Database installer
+    Module\WsOrderreference\Database\ReferenceInstaller:
+        public: true
+        arguments:
+            - "@doctrine.dbal.default_connection"
+            - "%database_prefix%"

composer.json

@@ -7,15 +7,13 @@
             "email": "isabelle@dewebsmid.nl"
         }
     ],
-    "require": {
-        "php": ">=8.2.0"
-    },
     "autoload": {
         "psr-4": {
-            "Module\\WsOrderreference\\": "src/"
+            "Websmid\\OrderReference\\": "src/"
         },
         "classmap": [
-            "ws_orderreference.php"
+            "ws_orderreference.php",
+            "classes/"
         ],
         "exclude-from-classmap": []
     },

config/routes.yml

@@ -0,0 +1,5 @@
+ws_orderreference_get_reference:
+    path: /order-reference/{id_order}
+    methods: [GET]
+    defaults:
+        _controller: 'Module\WsOrderreference\Controller\OrderReferenceController::getReferenceAction'

config/services.yml

@@ -4,15 +4,8 @@ services:
         autoconfigure: true
 
     # Repository - this makes it available via dependency injection
-    Module\WsOrderreference\Repository\OrderReferenceRepository:
+    Websmid\OrderReference\Repository\OrderReferenceRepository:
         public: true
         factory: ["@doctrine.orm.default_entity_manager", getRepository]
         arguments:
-            - Module\WsOrderreference\Entity\OrderReference
-
-    # Database installer
-    Module\WsOrderreference\Database\ReferenceInstaller:
-        public: true
-        arguments:
-            - "@doctrine.dbal.default_connection"
-            - "%database_prefix%"
+            - Websmid\OrderReference\Entity\OrderReference

controllers/front/ajax.php

@@ -1,7 +1,7 @@
 <?php
 
-use Module\WsOrderreference\Entity\OrderReference;
-use Module\WsOrderreference\Repository\OrderReferenceRepository;
+use Websmid\OrderReference\Entity\OrderReference;
+use Websmid\OrderReference\Repository\OrderReferenceRepository;
 
 if (file_exists(__DIR__ . '../../vendor/autoload.php')) {
     require_once __DIR__ . '../../vendor/autoload.php';
@@ -30,6 +30,7 @@ class ws_orderreferenceAjaxModuleFrontController extends ModuleFrontController
             return;
         }
 
+        
         try {
             /** @var \Doctrine\ORM\EntityManagerInterface $entityManager */
             $entityManager = $this->get('doctrine.orm.default_entity_manager');
@@ -37,14 +38,14 @@ class ws_orderreferenceAjaxModuleFrontController extends ModuleFrontController
             /** @var OrderReferenceRepository $repository */
             $repository = $entityManager->getRepository(OrderReference::class);
         
-            $orderRef = $repository->findByCartId($idCart);
+            $orderRef = $repository->findByCartId((int)$idCart);
             
             if (!$orderRef) {
                 $orderRef = new OrderReference();
-                $orderRef->setIdCart($idCart);
+                $orderRef->setIdCart((int)$idCart);
             }
             
-            $orderRef->setOrderReference($orderReference);
+            $orderRef->setOrderReference(pSQL($orderReference));
 
             $entityManager->persist($orderRef);
             $entityManager->flush();

src/Config/Config.php

@@ -0,0 +1,18 @@
+<?php
+
+namespace Websmid\OrderReference\Config;
+
+class Config
+{
+    const DISPLAYABLE_HOOKS = [
+        'displayShoppingCart'    => 'displayShoppingCart',
+        'displayPDFDeliverySlip' => 'displayPDFDeliverySlip',
+    ];
+
+    const HOOKS = [
+        'displayShoppingCart',
+        'displayPDFDeliverySlip',
+        'addWebserviceResources',
+        'actionFrontControllerSetMedia',
+    ];
+}

src/Controller/OrderReferenceController.php

@@ -0,0 +1,19 @@
+<?php
+namespace Websmid\WsOrderReference\Controller;
+
+use PrestaShopBundle\Controller\Admin\PrestaShopAdminController;
+use Symfony\Component\HttpFoundation\JsonResponse;
+
+class OrderReferenceController extends PrestaShopAdminController
+{
+    public function getReferenceAction(int $id_order)
+    {
+        // Dummy data for testing. See https://simonspeelgoed.websmid.dev/api/order_reference 
+        
+        return new JsonResponse([
+            'orderId' => $id_order,
+            'customReference' => 'DUMMY-REF-12345',
+            'status' => 'This is a test response'
+        ]);
+    }
+}

src/Database/ReferenceInstaller.php

@@ -1,82 +0,0 @@
-<?php
-/**
- *  2026 De Websmid
- *
- *  @author    De Websmid <contact@De Websmid.com>
- *  @copyright 2026 De Websmid
- *  @license   De Websmid
- * 
- * NOTICE OF LICENSE
- *
- * This source file is subject to the Academic Free License 3.0 (AFL-3.0).
- * It is also available through the world-wide-web at this URL: https://opensource.org/licenses/AFL-3.0
- */
-
-declare(strict_types=1);
-
-namespace Module\WsOrderreference\Database;
-
-use Doctrine\DBAL\Connection;
-use Doctrine\DBAL\Exception as DBALException;
-
-class ReferenceInstaller
-{
-    private Connection $connection;
-    private string $dbPrefix;
-
-    public function __construct(Connection $connection, string $dbPrefix)
-    {
-        $this->connection = $connection;
-        $this->dbPrefix = $dbPrefix;
-    }
-
-    public function createTables(): array
-    {
-        $errors = [];
-        $this->dropTables();
-        $sqlInstallFile = dirname(__DIR__) . '/Resources/data/install.sql';
-
-        $sqlContent = file_get_contents($sqlInstallFile);
-        $sqlContent = str_replace('PREFIX_', $this->dbPrefix, $sqlContent);
-        
-        $sqlQueries = array_filter(array_map('trim', explode(';', $sqlContent)));
-
-        foreach ($sqlQueries as $query) {
-            if (empty($query)) {
-                continue;
-            }
-
-            try {
-                $this->connection->executeQuery($query);
-            } catch (DBALException $e) {
-                $errors[] = [
-                    'key' => $e->getMessage(),
-                    'parameters' => [],
-                    'domain' => 'Admin.Modules.Notification',
-                ];
-            }
-        }
-        return $errors;
-    }
-
-    public function dropTables(): array
-    {
-        $errors = [];
-        $tableNames = [
-            'ws_orderreference',
-        ];
-        foreach ($tableNames as $tableName) {
-            $sql = 'DROP TABLE IF EXISTS ' . $this->dbPrefix . $tableName;
-            try {
-                $this->connection->executeQuery($sql);
-            } catch (DBALException $e) {
-                $errors[] = [
-                    'key' => $e->getMessage(),
-                    'parameters' => [],
-                    'domain' => 'Admin.Modules.Notification',
-                ];
-            }
-        }
-        return $errors;
-    }
-}

src/Entity/OrderReference.php

@@ -10,13 +10,13 @@
 
 declare(strict_types=1);
 
-namespace Module\WsOrderreference\Entity;
+namespace Websmid\OrderReference\Entity;
 
 use Doctrine\ORM\Mapping as ORM;
 
 /**
  * @ORM\Table()
- * @ORM\Entity(repositoryClass="Module\WsOrderreference\Repository\OrderReferenceRepository")
+ * @ORM\Entity(repositoryClass="Websmid\OrderReference\Repository\OrderReferenceRepository")
  */
 class OrderReference
 {

src/Module/Install.php

@@ -1,45 +1,49 @@
 <?php
 
-namespace Module\WsOrderreference\Module;
+namespace Websmid\OrderReference\Module;
 
-use Module\WsOrderreference\Database\ReferenceInstaller;
+use Db;
+use Websmid\OrderReference\Config\Config;
 
 trait Install
 {
     public function install()
     {
-        return $this->installTables() 
-            && parent::install()
-            && $this->registerHook('displayShoppingCart')
-            && $this->registerHook('displayPDFDeliverySlip')
-            && $this->registerHook('actionFrontControllerSetMedia');
+        if (!parent::install()) {
+            return false;
+        }
+        if (!$this->createTables()){
+            return false;
+        }
+        if (!$this->registerHooks()){
+            return false;
         }
 
-    private function getInstaller(): ReferenceInstaller
+        return true;
+    }
+    
+    private function createTables(): bool
     {
-        try {
-            $installer = $this->get(ReferenceInstaller::class);
-        } catch (\Throwable $e) {
-            $installer = null;
+        $sql = 'CREATE TABLE IF NOT EXISTS `' . _DB_PREFIX_ . 'ws_order_reference` (
+            `id` int(11) NOT NULL AUTO_INCREMENT,
+            `id_cart` int(11) NOT NULL,
+            `order_reference` varchar(255) NOT NULL,
+            PRIMARY KEY (`id`),
+            UNIQUE KEY `id_cart` (`id_cart`)
+        );';
+
+        return Db::getInstance()->execute($sql);
     }
         
-        if (!$installer) {
-            $installer = new ReferenceInstaller(
-                $this->get('doctrine.dbal.default_connection'),
-                $this->getContainer()->getParameter('database_prefix')
-            );
-        }
-
-        return $installer;
-    }
-
-    private function installTables(): bool
+    public function registerHooks(): bool
     {
-        /** @var ReferenceInstaller $installer */
-        $installer = $this->getInstaller();
-        $errors = $installer->createTables();
+        foreach (Config::HOOKS as $hook) {
+            if (!$this->registerHook($hook)) {
+                return false;
+            }
+        }
 
-        return empty($errors);
+        return true;
     }
     
 }

src/Module/actionHooks.php

@@ -1,12 +1,14 @@
 <?php 
 
-namespace Module\WsOrderreference\Module;
+namespace Websmid\OrderReference\Module;
 
-trait actionHooks
+use Media;
+
+trait ActionHooks
 {
     public function hookActionFrontControllerSetMedia($params)
     {
-        \Media::addJsDef([
+        Media::addJsDef([
             'ajax_url' => $this->context->link->getModuleLink($this->name, 'ajax'),
         ]);
         
@@ -22,4 +24,20 @@ trait actionHooks
             ['media' => 'all', 'priority' => 150]
         );
     }
+    
+    // Register in web service using specific management to bypass objectmodel handling and return custom data.
+    // I used specific_management because otherwise I'd have to make an objectmodel which conflicts with the doctrine entity I made. 
+    // Instead of having to manage two places where the order reference is handled, I can just use the specific management to return the data from the db directly.
+    
+    // See classes/webservice/WebserviceSpecificManagementInterface.php for the interface contract.
+    
+    public function hookAddWebserviceResources($params)
+    {
+        return [
+            'order_reference' => [ 
+                'description' => 'Order references from the ws_orderreference module',
+                'specific_management' => true, 
+            ],
+        ];
+    }
 }

src/Module/displayHooks.php

@@ -1,8 +1,8 @@
 <?php 
 
-namespace Module\WsOrderreference\Module;
+namespace Websmid\OrderReference\Module;
 
-trait displayHooks
+trait DisplayHooks
 {
     public function hookDisplayShoppingCart($params)
     {
@@ -13,7 +13,7 @@ trait displayHooks
     {
         $orderId = $params['object']->id_order;
         
-        $orderReferenceRepo = \PrestaShop\PrestaShop\Adapter\SymfonyContainer::getInstance()->get('Module\WsOrderreference\Repository\OrderReferenceRepository');
+        $orderReferenceRepo = \PrestaShop\PrestaShop\Adapter\SymfonyContainer::getInstance()->get('Websmid\OrderReference\Repository\OrderReferenceRepository');
         $orderReference = $orderReferenceRepo->customRefByOrderId($orderId);
 
         $this->context->smarty->assign('orderReference', $orderReference);

src/Repository/OrderReferenceRepository.php

@@ -9,10 +9,10 @@
 
 declare(strict_types=1);
 
-namespace Module\WsOrderreference\Repository;
+namespace Websmid\OrderReference\Repository;
 
 use Doctrine\ORM\EntityRepository;
-use Module\WsOrderreference\Entity\OrderReference;
+use Websmid\OrderReference\Entity\OrderReference;
 
 class OrderReferenceRepository extends EntityRepository
 {
@@ -27,6 +27,27 @@ class OrderReferenceRepository extends EntityRepository
         return $this->findOneBy(['idCart' => $cartId]);
     }
 
+    /**
+     * Find order reference entity by order ID (via cart lookup)
+     *
+     * @param int $orderId
+     * @return OrderReference|null
+     */
+    public function findByOrderId(int $orderId): ?OrderReference
+    {
+        $conn = $this->getEntityManager()->getConnection();
+        $sql = 'SELECT id_cart FROM ' . _DB_PREFIX_ . 'orders WHERE id_order = :orderId';
+        $stmt = $conn->prepare($sql);
+        $resultSet = $stmt->executeQuery(['orderId' => $orderId]);
+        $idCart = $resultSet->fetchOne();
+
+        if ($idCart) {
+            return $this->findByCartId((int) $idCart);
+        }
+
+        return null;
+    }
+
    // Create a function that accepts an order Id and uses the cart ID to check if there is a custom order reference.
    // Requires an order ID as a parameter.
    // Returns the order reference if found, otherwise returns null.
@@ -39,7 +60,7 @@ class OrderReferenceRepository extends EntityRepository
     public function customRefByOrderId(int $orderId): ?string
     {
         $conn = $this->getEntityManager()->getConnection();
-        $sql = 'SELECT id_cart FROM ps_orders WHERE id_order = :orderId';
+        $sql = 'SELECT id_cart FROM ' . _DB_PREFIX_ . 'orders WHERE id_order = :orderId';
         $stmt = $conn->prepare($sql);
         $resultSet = $stmt->executeQuery(['orderId' => $orderId]);
         $idCart = $resultSet->fetchOne();

src/Resources/data/install.sql

@@ -1,7 +0,0 @@
-CREATE TABLE IF NOT EXISTS `PREFIX_order_reference` (
-  `id` int(11) NOT NULL AUTO_INCREMENT,
-  `id_cart` int(11) NOT NULL,
-  `order_reference` varchar(255) NOT NULL,
-  PRIMARY KEY (`id`),
-  UNIQUE KEY `id_cart` (`id_cart`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8;

ws_orderreference.php

@@ -4,10 +4,9 @@ if (!defined('_PS_VERSION_')) {
     exit;
 }
 
-use Module\WsOrderreference\Module\Install;
-use Module\WsOrderreference\Module\displayHooks;
-use Module\WsOrderreference\Module\actionHooks;
-
+use Websmid\OrderReference\Module\Install;
+use Websmid\OrderReference\Module\DisplayHooks;
+use Websmid\OrderReference\Module\ActionHooks;
 
 if (file_exists(__DIR__ . '/vendor/autoload.php')) {
     require_once __DIR__ . '/vendor/autoload.php';
@@ -19,20 +18,17 @@ class Ws_OrderReference extends Module
     protected $orderReferenceRepository;
 
     use Install;
-    use displayHooks;
-    use actionHooks;
+    use DisplayHooks;
+    use ActionHooks;
+
 
     public function __construct()
     {
         $this->name = 'ws_orderreference';
         $this->tab = 'other';
         $this->version = '1.0.0';
-        $this->author = 'Isabelle Oving-Anno | De Websmid b.v.';
+        $this->author = 'Isabelle Oving-Anno | De Websmid B.V.';
         $this->need_instance = 0;
-        $this->ps_versions_compliancy = [
-            'min' => '9.0.0',
-            'max' => '9.99.99',
-        ];
         $this->bootstrap = true;
 
         parent::__construct();
@@ -40,5 +36,4 @@ class Ws_OrderReference extends Module
         $this->displayName = $this->l('Order Reference');
         $this->description = $this->l('Adds an optional order reference field to the shopping cart summary.');
     }
-
 }