WP Manifestindependent plugin directory
manifest / ecommerce / arvan-reseller

Arvan Reseller

WordPress plugin for selling and managing Arvan Cloud services (Cloud Server, Object Storage, CDN) as a reseller.

by Arvan Reseller Challenge · github.com/alimeftahii1998/arvan-reseller · website

★ 0stars
0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/alimeftahii1998/arvan-reseller/archive/refs/heads/main.zip

Readme

Arvan Reseller — WordPress Plugin v1.0.0

WordPress plugin for selling and managing Arvan Cloud services (Cloud Server, Object Storage, CDN) as a reseller.

Features

  • Setup Wizard (RTL, Persian)
  • Encrypted credential storage (SecretManager)
  • Product catalog with markup pricing
  • Customer wallet and atomic transactions
  • Checkout + mock payment (development)
  • Real Arvan API integration (documented OpenAPI only)
  • Service provisioning, sync, restriction + notifications
  • Usage billing engine + settlement foundation
  • Customer portal (/my-account/)
  • Admin dashboard (business + operational health)
  • Demo Center (development only)

Requirements

  • WordPress 6.0+
  • PHP 8.1+
  • MySQL/MariaDB

Installation

  1. Copy plugin/arvan-reseller to wp-content/plugins/arvan-reseller
  2. Activate Arvan Reseller
  3. Complete the Setup Wizard
  4. Set environment (development for demos, production for live)
  5. Optionally configure Arvan API key / access token in Settings
  6. If portal/store URLs 404 → Settings → Permalinks → Save

Configuration

Setting Notes
Store name / about / contact Public storefront
Environment development enables Demo Center
API Key / Access Token Stored encrypted; UI shows masked labels
Low / critical balance Restriction thresholds (IRR)

Demo steps (evaluators)

  1. Environment = development
  2. Arvan Reseller → Demo Center → ایجاد داده دمو
  3. Review Dashboard cards (revenue, orders, active services, low-balance, failed provisioning)
  4. Open portal /my-account/ scenarios (Normal / Warning / Suspended customers)
  5. Optional: Run Billing Simulation / Restriction Simulation
  6. Follow docs/final/demo-script.md (5–8 minutes)

Scenario wallets: Active 50M · Low 5M · Suspended 0 IRR.

Documentation

Document Description
docs/final/FINAL_ARCHITECTURE.md Architecture
docs/final/FINAL_USER_FLOW.md Customer journey
docs/final/FINAL_API_STATUS.md API implemented vs blocked
docs/final/FINAL_SECURITY_REPORT.md Security model
docs/final/FINAL_CHALLENGE_MAPPING.md Requirement → files
docs/final/demo-script.md Live demo script
docs/final/FINAL_CHECKLIST.md Submission checklist

Limitations

  • Mock payment only (no real PSP)
  • Real Arvan suspend not invented → api_not_available
  • CDN provisioning may be blocked where docs are incomplete
  • Settlement foundation has no real payout
  • Demo tools are disabled in production

Testing

php scripts/validate-plugin.php
php plugin/arvan-reseller/tests/run-tests.php

Version

  • Plugin: 1.0.0
  • Database: 8

Read the full README on GitHub →