Merge pull request #1745 from abantecart/1.4.3

1.4.3

Author: abantecart

.aiassistant/rules/abantecart_v1.md

@@ -0,0 +1,66 @@
+---
+apply: always
+---
+
+# Language & Tone
+- Keep answers concise and practical: show code first, then a short explanation.
+
+# Project Conventions
+- Follow PSR-12 coding style (namespaces, braces, imports, indentation).
+- Always type-hint parameters, return types, and class properties.
+- Use short array syntax `[]`.
+- Prefer modern PHP features: null-coalescing, nullsafe operator, constructor property promotion.
+- Use single quotes for strings unless interpolation is required.
+- Use double quotes for sql-queries.
+- Keep controllers skinny; put business logic in models/services.
+- Do not echo in controllers; assign data to views and return.
+- Save all text's key and value into language "xml" files inside tag <definition><key></key><value></value></definition>. Path of xml file should be the same as controller.
+- Do not use inline texts inside "php" and "tpl" files. Use call $this->language->get('language_definition_key','route') instead.
+- In case of extension, use the extension's text ID (key) as prefix for all it's language definition keys. 
+- Route parameter is not necessary when the route of a language file is equal route of controller
+- All html-attributes inside tpl files should be wrapped function echo_html2view() or html2view(). For javascript code inside tpl-file use js_echo() function for php-variables.
+- do not use Javascript code in the tpl files under storefront directory, except in common/*.tpl. Use common/head.tpl for defining of js variables based on php-variables values and use them inside main.js or common.js files.
+
+    
+
+# Error Handling & Logging
+- Never use `@` to suppress errors.
+- Do not use `die/exit/var_dump/print_r` in examples.
+- Throw specific exceptions (InvalidArgumentException, RuntimeException, etc.) with clear messages.
+
+# Project Structure (paths are illustrative)
+- Storefront controllers: storefront/controller/pages/* or extensions/<ext_key>/storefront/controller/*
+- Admin controllers: admin/controller/pages/* or extensions/<ext_key>/admin/controller/*
+- Models: */model/*/*.php
+- Views/templates: */view/<theme>/template/*/*.tpl
+- Language files: */language/<language>/*/*.xml
+- Assets: */view/<theme>/css|js|image/* or extension assets folder
+
+# Security
+- For hashing passwords, use `passwordHash()`.
+- Never invent your own crypto.
+
+# Architecture
+- Keep controllers thin. Put business logic into services, persistence in repositories.
+- Use DTOs or Value Objects instead of raw arrays in public APIs.
+- Favor immutable Value Objects (Email, Money, Uuid).
+- Use dependency injection (constructor injection), not service locators.
+
+# Testing
+
+# Documentation
+- Add PHPDoc only when it adds value (e.g., generics for collections).
+- For utility classes, add a small "Usage" example in comments.
+- Add PHPDoc comment before call of method "processTemplate". It must be @see real path which started with public_html
+
+# Performance
+- Avoid premature optimization, but do not create obvious N+1 queries.
+- Use generators (yield) for large collections when appropriate.
+
+# Prohibited Patterns
+- Do not use: `var_dump`, `print_r`, `dd`, `exit`, global singletons, or magic methods `__get/__set` in domain models.
+- Do not generate "// TODO: implement". Always provide a minimal working implementation.
+
+# Static Analysis
+- Code must be compatible with PHPStan/Psalm (high strictness).
+- Support generics in collections via PHPDoc where needed.

.github/workflows/test.yml

@@ -15,12 +15,12 @@ jobs:
         db:
           - ver: mysql
             release: '8.0'
-          - ver: mysql
-            release: latest
+#          - ver: mysql
+#            release: latest
           - ver: mariadb
             release: '10.5.25'
-          - ver: mariadb
-            release: latest
+#          - ver: mariadb
+#            release: latest
       fail-fast: false
 
     steps:

.gitignore

@@ -21,3 +21,25 @@
 /public_html/extensions/novator/storefront/view/novator/default_preset_prepared.json
 /public_html/storefront/view/default/default_preset_prepared.json
 /public_html/system/page_builder/presets/novator/
+/public_html/.htaccess
+/public_html/extensions/default_croatian/
+/public_html/extensions/default_czech/
+/public_html/extensions/default_danish/
+/public_html/extensions/default_deutsch/
+/public_html/extensions/default_finnish/
+/public_html/extensions/default_french/
+/public_html/extensions/default_greek/
+/public_html/extensions/default_hebrew/
+/public_html/extensions/default_hindi/
+/public_html/extensions/default_hungarian/
+/public_html/extensions/default_italian/
+/public_html/extensions/default_korean/
+/public_html/extensions/default_norwegian/
+/public_html/extensions/default_polish/
+/public_html/extensions/default_portuguese/
+/public_html/extensions/default_russian/
+/public_html/extensions/default_simplified_chinese/
+/public_html/extensions/default_slovene/
+/public_html/extensions/default_spanish/
+/public_html/extensions/default_swedish/
+/public_html/extensions/default_ukrainian/

README.md

@@ -1,71 +1,141 @@
+<p align="center">
+  <a href="https://www.abantecart.com">
+    <img src="https://www.abantecart.com/resources/image/18/7c/8.png" alt="AbanteCart Logo" width="300">
+  </a>
+</p>
 
-# AbanteCart eCommerce Platform [![Build Status](https://travis-ci.org/abantecart/abantecart-src.svg?branch=master)](https://travis-ci.org/abantecart/abantecart-src)
+<p align="center">
+  <a href="https://github.com/abantecart/abantecart-src/blob/master/LICENSE.txt"><img src="https://img.shields.io/badge/license-OSL%203.0-blue.svg" alt="License"></a>
+  <a href="https://github.com/abantecart/abantecart-src/releases"><img src="https://img.shields.io/github/v/release/abantecart/abantecart-src" alt="Release Version"></a>
+  <a href="https://github.com/abantecart/abantecart-src/issues"><img src="https://img.shields.io/github/issues/abantecart/abantecart-src.svg" alt="Issues"></a>
+</p>
 
+---
 
-## Overview
+## 🚀 Overview
 
-AbanteCart is a free open source ecommerce platform to power online retail. AbanteCart is a ready to run web application as well as reliable foundation to build custom eCommerce solutions. 
-AbanteCart ecommerce platform is designed to fit a wide variety of online businesses and applications, as well as can be configured or customized to perform very specific business requirements. Chosen by many shop owners launching their business online for the first time, AbanteCart is also picked by developers looking for a user-friendly interface and powerful features set. 
+**AbanteCart** is a free and open-source eCommerce platform designed to power modern online retail and digital commerce. Whether you're launching your first store or developing a complex eCommerce solution, AbanteCart offers a robust and extensible foundation.
 
-## Reporting issues
+- 🧩 Modular, extensible architecture  
+- ⚡ Lightweight, fast, and secure  
+- 📦 Rich feature set with a user-friendly admin interface  
+- 🎯 Built for developers and business owners  
 
-Read the instructions below before you report an issue or a bug.
+👉 Explore the [Live Demo](https://www.abantecart.com/shopping-cart-demo)  
+👉 Learn more at [abantecart.com](https://www.abantecart.com)
 
- 1. Search the [AbanteCart forum](http://forum.abantecart.com), ask the community if they know about the issue or can suggest how to resolve it.
- 2. Check open and closed issues on the [GitHub bug tracker](https://github.com/abantecart/abantecart-src/issues).
- 3. READ the [changelog for the master branch](https://github.com/abantecart/abantecart-src/blob/master/release_notes.txt)
- 4. Try [Google](http://www.google.com) to search for your issue.
- 5. As many issues occur due to hosting environment related settings and problems, please make sure that your issue is not related only  to your hosting set up. 
+---
 
-If issue you report is not yet reported and related to the AbanteCart core code, please report it on GitHub. Provide as much details as needed and include screenshots.
+## 📦 Getting Started
 
-**Important!**
-- Issues that are not related to the core code (such as a third party extension or your server configuration) might be closed without explanation. You need to contact extension developer, use the forum or find a third partner to resolve a custom code issue.
-- If you need to report a security bug, please PM an AbanteCart moderator/administrator on the forum first. All security reports are taken seriously but you must include detailed steps to reproduce them. Please do not report theoretical security flaws and donot post security flaws in a public location.
+### ✅ Requirements
 
-## Making a suggestion
+- PHP 8.2.x  
+- MySQL 8.0+ or MariaDB 10.5+  
+- Apache or Nginx  
+- `mod_rewrite` enabled  
 
-We like improvements, but improvements are not bugs or issue. Please do not create an issue report if you think something needs improving (such as features or change to code standards etc).
-We welcome public suggestions on our [AbanteCart forum](http://forum.abantecart.com).
+### 🛠️ Installation
 
-## How to contribute
+1. Clone the repository:
+   ```bash
+   git clone https://github.com/abantecart/abantecart-src.git
+   ```
 
-Fork the repository, edit and submit a pull request to branch that has latest version in development.
+2. Web installation
+   ```
+   Place contents of `/public_html` in your web root directory.
+   Open your browser and navigate to:
+       http://localhost/abantecart-src/public_html/
+   Follow the web installer instructions.
+   ```
+3. or CLI installation:
+   ```
+   cd /path/server/htdocs/
+   php ./install/cli_install.php install --db_host=127.0.0.1 --db_user=**** --db_password=**** --db_name=****  --db_driver=amysqli  --db_prefix=abc_ --admin_path=admin  --username=admin  --password=admin  --email=admin@admin.com  --http_server=https://your_domain/ --with-sample-data=abantecart_sample_data.sql
+   ``` 
 
-Please be very clear on your commit messages and pull request, empty pull request messages are not accepted.
+📚 Detailed instructions: [Installation Guide](https://abantecart.atlassian.net/wiki/spaces/AD/pages/4292610/Installation)
 
-Your code standards should match the AbanteCart coding standards. 
+---
 
-## Versioning
+## 🧠 Documentation
 
-The version is broken down into 4 parts e.g 1.2.3.1 (MAJOR.MINOR.BULD.REVISION) to describe the version numbers.
+- 📖 [Developer Docs](https://docs.abantecart.com)  
+- 💡 [Community Forum](https://forum.abantecart.com)  
+- 🧩 [Extension Marketplace](https://marketplace.abantecart.com)
 
-A MAJOR is very rare, it would only be considered if the source was effectively re-written or a clean break was desired for other reasons. This increment would likely effect and break third party extensions
+---
 
-A MINOR is when there are significant changes that affect core structures. This increment would likely effect some third party extensions.
+## 🐞 Reporting Issues
 
-A BULD version is when new features are added. Updating a feature version is at a low risk of effecting third party extensions.
+Before submitting an issue, please:
 
-A REVISION version is when a fix is added, it should be considered safe to update revision versions e.g 1.2.3.1 to 1.2.3.2
+1. Search the [AbanteCart forum](https://forum.abantecart.com)  
+2. Check [existing GitHub issues](https://github.com/abantecart/abantecart-src/issues)  
+3. Review the [changelog](https://github.com/abantecart/abantecart-src/blob/master/release_notes.txt)  
+4. Confirm it’s not an issue with your hosting/server environment  
 
-## Releases
+> ❗ **Security Issues**  
+> Please do **not** post security issues publicly. Contact a moderator privately via the [AbanteCart site](https://www.abantecart.com/index.php?rt=content/contact).
 
-AbanteCart will announce to developers 1-2 week prior to public release of BULD versions, this is to allow for testing of their own extensions for compatibility. For bigger releases an extended period will be considered following an announced release candidate. Revision versions may have a significantly reduced developer release period.
-Prerelease will be also announced on a forum.
+---
 
-To receive developer notifications about release information, sign up to the newsletter on the [AbanteCart website](http://www.AbanteCart.com) - located in the footer. 
+## 💡 Suggest Features
 
-## How to install
+Have an idea or enhancement in mind?  
+Share your suggestions on our [Community Forum](https://forum.abantecart.com/index.php/board,25.0.html).
 
-Please read the installation options and instructions on [AbanteCart website](http://www.abantecart.com/ecommerce-getting-started).
+---
 
-## License
+## 🤝 Contributing
 
-[Open Software License (OSL 3.0)](https://github.com/abantecart/abantecart-src/blob/master/LICENSE.txt)
+We welcome contributions! Follow these steps:
 
-## Links
+1. Fork the repo  
+2. Create a feature branch  
+3. Submit a pull request to the appropriate development branch  
 
-- [AbanteCart homepage](http://www.abantecart.com/)
-- [AbanteCart forums](http://forum.abantecart.com/)
-- [AbanteCart Marketplace](http://marketplace.abantecart.com/)
-- [How to documents](http://docs.abantecart.com/)
+📌 Please follow PHP [coding standards](https://www.php-fig.org/psr/psr-12/) and include meaningful commit messages.
+
+---
+
+## 🔢 Versioning
+
+AbanteCart uses **four-part versioning**: `MAJOR.MINOR.BUILD.REVISION`
+
+- `MAJOR` – Breaking changes or complete rewrites  
+- `MINOR` – Significant changes to core  
+- `BUILD` – New features (safe upgrade path)  
+- `REVISION` – Bug fixes (safe for all)
+
+---
+
+## 📢 Releases
+
+- Stay updated by subscribing to our newsletter on [abantecart.com](https://www.abantecart.com) (footer).
+
+---
+
+## 📜 License
+
+Distributed under the [Open Software License (OSL 3.0)](https://opensource.org/licenses/OSL-3.0).
+
+---
+
+## 🔗 Useful Links
+
+- 🌐 [Official Website](https://www.abantecart.com)  
+- 📘 [Documentation](https://docs.abantecart.com)  
+- 🧩 [Extension Marketplace](https://marketplace.abantecart.com)  
+- 🗣️ [Community Forum](https://forum.abantecart.com)  
+- 🎥 [YouTube Tutorials](https://www.youtube.com/@abantecart/videos)
+
+---
+
+## ❤️ Made With Passion
+
+AbanteCart is maintained by a passionate team of developers and contributors.  
+Help us build the future of open-source commerce! 
+
+---

public_html/.htaccess.txt

@@ -10,16 +10,25 @@
 
 # For any support issues please visit: https://forum.abantecart.com
 
-Options +FollowSymlinks
+Options +SymLinksIfOwnerMatch
 
 # Prevent Directory listing
 Options -Indexes
 
 # Prevent Direct Access to files
-<FilesMatch "\.tpl">
-Order deny,allow
-Deny from all
-</FilesMatch>
+<IfModule !mod_authz_core.c>
+    # Apache 2.2
+    <FilesMatch "\.tpl$">
+        Order deny,allow
+        Deny from all
+    </FilesMatch>
+</IfModule>
+<IfModule mod_authz_core.c>
+    # Apache 2.4+
+    <FilesMatch "\.tpl$">
+        Require all denied
+    </FilesMatch>
+</IfModule>
 
 
 RewriteEngine on

public_html/admin/.htaccess

@@ -1,4 +1,14 @@
-<Files *.php>
-order allow,deny
-deny from all
-</Files>
+<IfModule !mod_authz_core.c>
+    # Apache 2.2
+    <FilesMatch "\.php$">
+        Order deny,allow
+        Deny from all
+    </FilesMatch>
+</IfModule>
+
+<IfModule mod_authz_core.c>
+    # Apache 2.4+
+    <FilesMatch "\.php$">
+        Require all denied
+    </FilesMatch>
+</IfModule>