# OstCapabilityDataExport

OstCapabilityDataExport for Shopware 6: Export live product data as configurable CSV files with pricing, stock, and category details.

## Overview

`OstCapabilityDataExport` is a Shopware plugin developed by Digitdrive.de. This README documents the delivered extension, its installation, configuration, and operation.

## Key Features

- Configurable CSV export for arbitrary Shopware DAL entity data
- Entity and field selection with optional filters, sorting, and scoped ID lists
- Preview endpoint and downloadable CSV with configurable delimiter, BOM, and file naming
- Clear plugin configuration with deterministic defaults
- Automated QA and compatibility checks in CI
- Store-ready documentation and release artifacts

## Compatibility

- shopware/core: >=6.5.8.10 <6.8.0.0
- Primary target: 6.5.8.10
- Matrix target: 6.5.8.10
- Matrix target: 6.6.1.0
- Matrix target: 6.7.0.0

## Installation

1. Upload the plugin to `custom/plugins/OstCapabilityDataExport`.
2. Run `bin/console plugin:refresh`.
3. Install and activate with `bin/console plugin:install --activate OstCapabilityDataExport`.

## Configuration

1. Open `Settings > Extensions > My extensions > OstCapabilityDataExport` in the Shopware Administration.
2. Define the CSV file name prefix and delimiter for your target system.
3. Decide whether the export should include only active products, stock columns, and category names.
4. Save the configuration before validating the preview route or downloading the CSV file.

## Usage

1. Open `/ost-capability-data-export` in the storefront to review a live export preview.
2. Download the complete CSV file from `/ost-capability-data-export/products.csv`.
3. Validate the generated columns against your product catalog before using the export in downstream systems.

## Quality Gates

- PHP CS Fixer
- PHPStan on all levels (0-9)
- PHPUnit
- Playwright browser tests against Dockware
- Dockware compatibility matrix

## Development & Release

- Source code follows PSR-4 autoloading and Shopware plugin conventions.
- Static analysis, coding standards, unit tests, and compatibility checks are part of the delivery workflow.
- The distributable ZIP package is available in `dist/`.

## Support

- Developer: Digitdrive.de
- Website: https://digitdrive.de
- Support: service@digitdrive.de
