=== Inkress Commerce ===
Contributors: inkress
Tags: ecommerce, payments, inkress, checkout, products
Requires at least: 5.8
Tested up to: 6.4
Requires PHP: 7.4
Stable tag: 1.0.0
License: MIT
License URI: https://opensource.org/licenses/MIT

Official Inkress Commerce integration for WordPress. Seamlessly integrate Inkress payments and products into your WordPress site.

== Description ==

Inkress Commerce is the official WordPress plugin for integrating Inkress payment processing and product management into your WordPress website. With this plugin, you can easily manage products, track orders, and display your Inkress products directly on your WordPress site using simple shortcodes.

= Features =

* **Product Management** - Create, edit, and delete products directly from WordPress admin
* **Order Tracking** - View and manage all your Inkress orders with pagination support
* **Frontend Display** - Display products using shortcodes with responsive grid layouts
* **Secure API Integration** - Direct connection to Inkress API with authentication
* **Dual Environment Support** - Switch between sandbox and production environments
* **Admin Dashboard** - Clean, intuitive interface for managing your e-commerce

= Shortcodes =

* `[inkress_products]` - Display a grid of products
  * Attributes: `limit` (number of products to show, default: 10)
  * Example: `[inkress_products limit="12"]`

* `[inkress_product id="123"]` - Display a single product
  * Attributes: `id` (required - product ID)
  * Example: `[inkress_product id="456"]`

= Requirements =

* Inkress merchant account ([Sign up at Inkress.com](https://inkress.com))
* Inkress API key
* WordPress 5.8 or higher
* PHP 7.4 or higher

= Documentation =

For detailed documentation, visit [Inkress Documentation](https://docs.inkress.com)

= Support =

* Plugin Support: [GitHub Issues](https://github.com/inkress/admin-sdk/issues)
* API Support: support@inkress.com
* Documentation: [https://docs.inkress.com](https://docs.inkress.com)

== Installation ==

= Automatic Installation =

1. Log in to your WordPress admin panel
2. Navigate to Plugins → Add New
3. Search for "Inkress Commerce"
4. Click "Install Now" and then "Activate"

= Manual Installation =

1. Download the plugin ZIP file
2. Log in to your WordPress admin panel
3. Navigate to Plugins → Add New → Upload Plugin
4. Choose the downloaded ZIP file and click "Install Now"
5. Click "Activate Plugin"

= Configuration =

1. After activation, go to **Inkress** in the WordPress admin menu
2. Enter your **API Key** (get this from your Inkress dashboard)
3. Enter your **Store ID** (your Inkress merchant username)
4. Select your **Environment** (Sandbox for testing, Production for live)
5. Click "Save Changes"

= First Steps =

After configuration:

1. Go to **Inkress → Products** to manage your products
2. Go to **Inkress → Orders** to view your orders
3. Use shortcodes on any page or post to display products

== Frequently Asked Questions ==

= Where do I get an API key? =

Log in to your Inkress merchant dashboard and navigate to Settings → API Keys. Generate a new API key for WordPress integration.

= What is the Store ID? =

Your Store ID is your Inkress merchant username. You can find this in your Inkress account settings.

= Can I test before going live? =

Yes! Select "Sandbox" environment in the plugin settings. This connects to the Inkress test environment where you can safely test the integration.

= How do I display products on my site? =

Use the `[inkress_products]` shortcode in any page or post. You can customize the number of products shown with the `limit` attribute.

= Are transactions secure? =

Yes. All API communication uses HTTPS and authentication tokens. The plugin never stores sensitive payment information.

= Does this work with WooCommerce? =

This plugin works independently of WooCommerce. You don't need WooCommerce installed to use Inkress Commerce.

= Can I customize the product display? =

Yes. The plugin includes basic styling, but you can override it with custom CSS in your theme. Product templates can also be customized using WordPress filters.

= What currencies are supported? =

Inkress supports multiple currencies including USD, JMD, and more. Currency settings are managed in your Inkress merchant dashboard.

= Is there a transaction fee? =

Transaction fees are determined by your Inkress merchant agreement. The plugin itself is free.

== Screenshots ==

1. Plugin settings page - Configure API credentials and environment
2. Products management page - Create, edit, and manage products
3. Orders list with pagination - Track all your Inkress orders
4. Product editor - Simple form for creating and editing products
5. Frontend product grid - Responsive product display using shortcodes
6. Single product display - Individual product cards

== Changelog ==

= 1.0.0 - 2026-01-05 =
* Initial release
* Product management (create, read, update, delete)
* Order tracking with pagination
* Frontend shortcodes for product display
* Sandbox and production environment support
* Admin dashboard interface
* Responsive product grid styling
* Security: nonce verification, input sanitization, capability checks
* Internationalization ready

== Upgrade Notice ==

= 1.0.0 =
Initial release of Inkress Commerce plugin.

== Privacy Policy ==

Inkress Commerce connects to the Inkress API to manage products and orders. When you use this plugin:

* API requests are sent to inkress.com servers
* Product and order data is transmitted securely via HTTPS
* Your API key is stored in your WordPress database
* No customer payment information is stored by this plugin
* Transaction data is processed according to Inkress privacy policy

For more information, see the [Inkress Privacy Policy](https://inkress.com/privacy).

== Additional Information ==

= Minimum Requirements =

* WordPress 5.8 or greater
* PHP version 7.4 or greater
* MySQL version 5.6 or greater OR MariaDB version 10.1 or greater

= Recommended Requirements =

* WordPress 6.0 or greater
* PHP version 8.0 or greater
* MySQL version 5.7 or greater OR MariaDB version 10.3 or greater
* HTTPS enabled on your website

= Developer Information =

This plugin is open source and welcomes contributions:

* GitHub Repository: [https://github.com/inkress/admin-sdk](https://github.com/inkress/admin-sdk)
* Issue Tracker: [https://github.com/inkress/admin-sdk/issues](https://github.com/inkress/admin-sdk/issues)
* Developer Docs: [https://docs.inkress.com/developers](https://docs.inkress.com/developers)

= Hooks & Filters =

The plugin provides several hooks for developers:

* `inkress_product_html` - Filter product card HTML
* `inkress_api_request_args` - Modify API request arguments
* `inkress_api_endpoint` - Filter API endpoint URLs
* `inkress_order_display_fields` - Customize order display fields

See developer documentation for complete filter reference.
