interblue.pl/.paul/codebase/structure.md

Codebase Structure

Analysis Date: 2026-04-27

Directory Layout

interblue.pl/
├── admin658c34/         # Admin panel (obfuscated path for security)
├── app/                 # Symfony app config, parameters
│   └── config/          # parameters.php (DB credentials, cache)
├── classes/             # PrestaShop core model classes
├── config/              # Bootstrap, defines, autoloader
├── controllers/         # Core front/admin controllers
├── custom/              # Custom utility files (medoo.php, scripts)
├── modules/             # 133 installed modules
├── override/            # Class and controller overrides
│   ├── classes/         # Core class overrides
│   │   ├── order/       # Order, OrderInvoice, OrderPayment, OrderCarrier
│   │   └── controller/  # FrontController override
│   ├── controllers/
│   │   └── front/       # ProductController, OrderController, CategoryController
│   └── modules/         # Module template overrides
├── src/                 # Custom CQRS extensions (Order domain)
│   ├── Adapter/Order/QueryHandler/
│   └── Core/Domain/Order/
├── themes/
│   └── InterBlue/       # Custom theme
│       ├── assets/
│       │   ├── css/     # SCSS sources + compiled CSS
│       │   └── js/      # custom.js
│       ├── config/      # theme.yml
│       ├── mails/pl/    # Polish email templates
│       └── templates/   # Smarty .tpl templates
├── var/cache/           # Compiled cache (do not edit)
├── .vscode/             # VS Code config (Live Sass, FTP)
├── .paul/               # PAUL project management
└── changelog/           # Daily changelogs (YYYY-MM-DD.md)

Directory Purposes

modules/ — Key custom and integration modules:

• modules/customfeaturetab/ — Custom product tabs from feature values
• modules/AddOrderExtraFields/ — Order source field (Allegro/Sklep int.)
• modules/x13allegro/ — Allegro marketplace (primary, v7.4.0)
• modules/empikmarketplace/ — Empik marketplace (v2.3.0)
• modules/baselinker/ — BaseLinker order management
• modules/onepagecheckoutps/ — One-page checkout
• modules/dpdpoland/, modules/sensbitinpost/, etc. — Shipping carriers
• modules/przelewy24/, modules/imoje/ — Payment gateways

override/ — Critical overrides:

• override/classes/order/Order.php — Hooks before invoice/delivery number (modrefchange)
• override/classes/Hook.php — GDPR cookie consent intercept (cookiesplus)
• override/classes/Dispatcher.php — Custom URL routing (fsadvancedurl)
• override/classes/Link.php — URL generation (fsadvancedurl)
• override/controllers/front/OrderController.php — One-page checkout (onepagecheckoutps)
• override/controllers/front/ProductController.php — Custom URL parsing

themes/InterBlue/ — Custom theme:

• assets/css/custom.scss — Main stylesheet (EDIT THIS for CSS changes)
• assets/css/custom.css — Compiled output (auto-generated, do not edit)
• assets/css/theme.scss — Theme base styles
• assets/js/custom.js — Custom JavaScript (jQuery)
• templates/catalog/product.tpl — Product detail page
• templates/catalog/listing/ — Category/listing pages
• templates/checkout/ — Checkout templates
• config/theme.yml — Theme config, hook assignments

src/ — CQRS Order extensions:

• src/Adapter/Order/QueryHandler/GetOrderForViewingHandler.php
• src/Core/Domain/Order/QueryHandler/GetOrderForViewingHandlerInterface.php
• src/Core/Domain/Order/QueryResult/ — Value objects

Key File Locations

Configuration:

• app/config/parameters.php — DB credentials, memcached, mailer config
• config/defines.inc.php — Constants, dev mode flag
• config/config.inc.php — Main PS bootstrap
• .vscode/ftp-kr.json — FTP deployment config
• .vscode/settings.json — Live Sass Compiler settings

Core Logic:

• override/classes/order/Order.php — Order creation hooks
• modules/AddOrderExtraFields/override/classes/PaymentModule.php — Order source logic
• modules/customfeaturetab/customfeaturetab.php — Feature tab module
• modules/customfeaturetab/classes/CustomFeatureTabRule.php — ObjectModel

Theme Entry:

• themes/InterBlue/assets/css/custom.scss — CSS entry point (edit this)
• themes/InterBlue/assets/js/custom.js — JS entry point

Admin:

• admin658c34/ — Admin panel root

Naming Conventions

Files:

• Module main files: {modulename}/{modulename}.php (e.g., customfeaturetab/customfeaturetab.php)
• ObjectModel classes: PascalCase (e.g., CustomFeatureTabRule.php)
• Admin controllers: Admin{Name}Controller.php
• Smarty templates: {page-name}.tpl in appropriate subdirectory

Directories:

• Modules: lowercase, no hyphens (e.g., customfeaturetab, addcolumninlist)
• Theme templates: follow PrestaShop structure (catalog/, checkout/, customer/)

Database Tables:

• Custom tables use ps_ prefix + module name (e.g., ps_custom_feature_tab)
• Module columns on core tables: ps_orders.order_source

Where to Add New Code

New CSS/SCSS changes:

• Edit: themes/InterBlue/assets/css/custom.scss
• Auto-compiled by Live Sass Compiler on save

New custom module:

• Create: modules/{modulename}/{modulename}.php
• ObjectModel: modules/{modulename}/classes/{ModelName}.php
• Admin controller: modules/{modulename}/controllers/admin/Admin{Name}Controller.php
• Templates: modules/{modulename}/views/templates/

New PrestaShop override:

• Add to: override/classes/{ClassName}.php or override/controllers/{type}/{Name}Controller.php
• Clear PS class index after: delete var/cache/*/class_index.php

New product page content:

• Hook: displayProductExtraContent (or displayProductAdditionalInfo)
• Implement in a module

Special Directories

var/cache/:

• Purpose: Compiled Smarty templates, class indexes, config cache
• Source: Auto-generated by PrestaShop
• Action: Clear via admin panel after PHP/template changes

admin658c34/:

• Purpose: Admin panel
• Security: Randomized folder name (obfuscation)
• Not in git (typically)

---

Structure analysis: 2026-04-27 Update when directory structure changes