# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## Project Overview

This is a **PrestaShop 1.7.8.11** e-commerce store (`kikiriki.sklep.pl`). The repository contains only the customized parts of the installation — overrides, custom modules, theme templates, and configuration — not the full PrestaShop core.

## Deployment

Files are deployed to a **live production server** via FTP:
- Host: `kikiriki.sklep.pl`
- Remote path: `/domains/kikiriki.sklep.pl/public_html`
- VS Code extension **ftp-kr** handles auto-upload on save (`autoUpload: true`)
- Files excluded from FTP sync: `.git`, `.vscode`, `.claude`, `.serena`, `CLAUDE.md`

There is no local development server. Changes go directly to production.

## Architecture

PrestaShop uses a **class override system**: files in `override/` extend or replace core classes. After adding or removing an override, the cache file `/cache/class_index.php` on the server must be deleted to force regeneration.

### Key directories in this repo

- `config/` — PrestaShop configuration files (`settings.inc.php` has DB credentials, `defines.inc.php` sets dev/prod mode)
- `controllers/admin/` and `controllers/front/` — Admin and storefront controller overrides
- `override/classes/` — Core class overrides (currently only `Order.php` for InPost shipping integration)
- `modules/` — Custom and third-party modules:
  - `eksporthistorii` — Custom module: exports order history to CSV, adds "Eksport historii" tab under Orders in admin
  - `ps_searchbar` — PrestaShop native search bar module (modified)
  - `x13googlemerchant` — Google Merchant Center XML feed (ionCube-encoded; main file is `xml.php`)
- `themes/classic/` — Classic theme customizations (Smarty `.tpl` templates, assets, email templates in Polish)

### Module structure pattern

Each module follows the PrestaShop standard:
- Main class in `<module_name>/<module_name>.php` extending `Module`
- Admin controllers in `controllers/admin/Admin<Name>Controller.php` extending `ModuleAdminController`
- Templates in `views/templates/`

### Override pattern

Override classes extend the `*Core` version of the class:
```php
class Order extends OrderCore { ... }
```

## Configuration

- **PS version**: `1.7.8.11` (defined in `config/settings.inc.php`)
- **Dev mode**: disabled by default (`_PS_MODE_DEV_ = false` in `config/defines.inc.php`)
- **DB prefix**: `pr_`
- **Caching**: Memcache configured but disabled (`_PS_CACHE_ENABLED_ = '0'`)
- **Language**: Polish (pl) — all custom UI strings are in Polish

## Important constraints

- `config/settings.inc.php` contains production DB credentials — never commit changes to this file that expose them further or modify the live credentials.
- `x13googlemerchant` module files (`.core.php`, `.db.php`, `.schema.php`) are ionCube-encoded and cannot be edited directly. Only `x13googlemerchant.php` (the loader) and `xml.php` (the feed entry point) are plain PHP.
- After editing any file in `override/`, the PrestaShop class cache must be cleared on the server: delete `/cache/class_index.php`.

## Sposób pracy
- Pisz do mnie po polsku, zwięźle i krótko, ale merytorycznie

## Wprowadzanie zmian
- Przeanalizuj wprowadzone zadanie
- Jeżeli masz jakieś wątpliwości pytaj
- Przedstaw plan
- Po akceptacji wdróź plan