FecMall 2.0

https://www.fecmall.com/doc/fecshop-guide/develop/cn-2.0/
Admin
FecMall 2.0 is an e-commerce development framework that provides comprehensive features for building...
Tokens:476,197
Snippets:1,407
Trust Score:7.8
Update:1 year ago
Show doc for...
Tokens:
Raw
### Fecmall Installation and Configuration

Source: https://www.fecmall.com/doc/fecshop-guide/develop/cn-2.0/guide-fecshop-2-search-engine

Guides on installing Fecmall, including different methods like WAMP, Baota, and interface installation, as well as SSL certificate configuration and upgrading.

```APIDOC
## Fecmall Installation and Configuration

### Description
This section provides comprehensive guides for installing Fecmall. It covers various installation methods such as WAMP on Windows 10, Baota server installation, and interface-based installation. Additionally, it includes instructions for configuring SSL certificates for HTTPS, upgrading Fecmall, and setting up the Vue client and WeChat Mini Program.

### Topics
- `Fecmall-2.x 介绍`: Introduction to Fecmall 2.x.
- `Fecmall-2.x 安装`: General installation guide for Fecmall 2.x.
- `Fecmall-2.x Win10本地-WAMP安装`: Installing Fecmall 2.x locally on Windows 10 using WAMP.
- `Fecmall-2.x 宝塔安装`: Installing Fecmall 2.x using the Baota control panel.
- `Fecmall-2.x 界面安装`: Installing Fecmall 2.x via the graphical interface.
- `Fecmall-2.x SSL证书 - HTTPS`: Configuring SSL certificates for HTTPS.
- `Fecmall-2.x 升级`: Guide on upgrading Fecmall 2.x.
- `Fecmall-2.x 安装VUE`: Installing the Vue.js frontend for Fecmall 2.x.
- `Fecmall-2.x 安装微信小程序`: Installing the WeChat Mini Program integration for Fecmall 2.x.
- `Fecmall-2和1版本差异`: Differences between Fecmall versions 2.x and 1.x.
```

--------------------------------

### Fecmall Interface Installation

Source: https://www.fecmall.com/doc/fecshop-guide/develop/cn-2.0/guide-fecshop-2-graphical-web-install

Step-by-step guide to installing Fecmall through the web interface after environment setup and initialization.

```APIDOC
## Fecmall Interface Installation

> After setting up the operating environment, downloading Fecmall, configuring Apache/Nginx, and running the command-line initialization, you can install Fecmall via the web interface.

### 1. Access Installation Entry
- The Fecmall interface installation entry file is located at: `$webroot/appfront/web/install/index.php`
- Open the installation address: `http://appfront.fecshoptest.com/install` (replace with your own domain).

### 2. Configure MySQL Database
- Fill in the MySQL configuration details.
- Click 'Submit'. The configuration will be written to `@common/config/main-local.php`.

### 3. Initialize Database Tables
- Click the 'Initialize Database Tables' button.
- This process may take some time. Upon completion, the interface will update.

### 4. Install Test Product Data (Optional)
- Click 'Install Test Product Data' to populate the database with sample data.
- Alternatively, click 'Skip' if you do not need test data.

### 5. Configure Domain Information
- Enter your domain name and select the store type.
- Click 'Next'. Ensure the domain is entered correctly without spaces.

### 6. Set Backend Admin Password
- Enter and confirm the password for the backend admin account.
- This password should be recorded for future logins.
- Click 'Next'.

### 7. Installation Complete
- The installation is now complete.
- Click the button to visit the PC storefront.
- Access the backend and HTML5 interfaces using your configured domain.

### Security Note for Production Environment:
- For security reasons in a production environment, set the read/write permissions for the database configuration file:
  - Execute (in the root directory, not needed for Windows): `chmod 644 common/config/main-local.php`

### Additional Information:

1.  **WeChat Mini Program**: For WeChat mini-program usage, consider the `fecyo` Chinese store extension and its corresponding mini-program. The default Fecmall mini-program is framework-oriented and has limited features.
    - Fecyo Chinese Extension Store: http://www.fecmall.com/fecyo

2.  **Fecmall 2.7.0+ Optimization**: Versions 2.7.0 and later have optimized the installation process, reducing several steps (e.g., backend settings). To add multi-language stores, configure them in the backend store settings.

3.  **Reinstallation**: If errors occur during installation and you wish to reinstall, clear the database tables and restart from the first step.
```

--------------------------------

### Fecmall Installation and Setup

Source: https://www.fecmall.com/doc/fecshop-guide/develop/cn-2.0/guide-fecmall-rewrite-func

Guides for installing and setting up Fecmall, including local WAMP installation, Baota panel installation, interface installation, SSL certificates, upgrades, and WeChat mini-program integration.

```APIDOC
## Fecmall Installation Guides

### Description
This section covers various methods for installing and configuring Fecmall, including:

- Fecmall 2.x Introduction
- Fecmall 2.x Installation
- Fecmall 2.x Local WAMP Installation on Win10
- Fecmall 2.x Baota Panel Installation
- Fecmall 2.x Interface Installation
- Fecmall 2.x SSL Certificate (HTTPS)
- Fecmall 2.x Upgrade Guide
- Fecmall 2.x Vue Installation
- Fecmall 2.x WeChat Mini Program Installation
- Differences between Fecmall 2.x and 1.x
```

--------------------------------

### Fecmall Installation Guide

Source: https://www.fecmall.com/doc/fecshop-guide/develop/cn-2.0/guide-fecshop-2-base-config

Provides detailed instructions for installing Fecmall on various platforms, including local WAMP, Baota panel, and with SSL certificates.

```APIDOC
## Fecmall Installation

### Description
Guides users through the installation process of Fecmall 2.x, covering local WAMP setups, Baota installation, interface installation, and SSL certificate configuration.

### Topics Covered
- Fecmall 2.x Introduction
- Fecmall 2.x Installation
- Fecmall 2.x Local WAMP Installation (Windows 10)
- Fecmall 2.x Baota Installation
- Fecmall 2.x Interface Installation
- Fecmall 2.x SSL Certificate (HTTPS)
- Fecmall 2.x Upgrade
- Fecmall 2.x Vue Installation
- Fecmall 2.x WeChat Mini Program Installation
- Differences between Fecmall 2.x and 1.x
```

--------------------------------

### Fecmall Help and Configuration

Source: https://www.fecmall.com/doc/fecshop-guide/develop/cn-2.0/guide-README

Provides helpful guides for configuring Fecmall, including basic setup, database configuration, search engine setup, multi-language store integration, and utilizing Redis, MongoDB, and Xunsearch.

```APIDOC
## Fecmall Help and Configuration

### Description
This section offers practical guides and configuration tips for setting up and utilizing various features within Fecmall.

### Helpful Guides:
- **Basic Configuration**: General setup instructions.
- **Service Database Configuration**: Configuring database connections for services.
- **Search Engine Configuration**: Setting up search engines like Xunsearch.
- **Adding Multi-language Stores**: Integrating support for multiple languages.
- **Using Redis**: Configuration and usage of Redis for caching and session management.
- **Using MongoDB**: Configuration and usage of MongoDB for data storage.
- **Using Xunsearch**: Integration and configuration for Xunsearch.
- **Shopfw Data Collection Assistant**: Guide for using the Shopfw data collection tool.
```

--------------------------------

### Fecmall 2.x Baota Installation Guide

Source: https://www.fecmall.com/doc/fecshop-guide/develop/cn-2.0/guide-fecshop-2-graphical-bt-install

Instructions for installing Fecmall 2.x using the Baota control panel. It highlights that the Fecmall download source via Baota is Alibaba Cloud OSS, defaulting to the latest version. The guide includes a link to a video tutorial and steps for setting up the LNMP environment (Nginx, MySQL, PHP) via the Baota panel.

```markdown
# Fecmall-2.x 宝塔安装 ¶
> 通过宝塔控制面板一键安装Fecmall
**注意：通过宝塔安装fecmall，fecmall的下载源是阿里云oss，默认是fecmall的最新版本** （您在宝塔里面看到的版本号请忽略，那是宝塔插件的版本号，不是fecmall版本号）
### 宝塔安装视频 ¶
Fecmall安装教学视频：Fecmall宝塔面板环境安装视频教程 ,如果您安装有难度，可以参看该`手把手安装`视频，参看`二.3`部分的视频。
### 购买服务器，安装宝塔，部署LNMP环境 ¶
1.宝塔的安装教程：https://www.bt.cn/bbs/thread-19376-1-1.html
宝塔面板场用命名：https://www.bt.cn/btcode.html
仔细看教程安装，如果是阿里云，注意`开启端口`，否则无法访问（宝塔安装教程有教程）
通过命令行安装后，会出现访问`宝塔控制面板地址`，以及`用户名`，`密码`，这个保存好
2.登陆宝塔控制面板
安装php，mysql，nginx,各个版本为：
`nginx`:`1.16.0`
`mysql`: `5.6.44`
`php`:`7.1`

```

--------------------------------

### Fecmall Help and Configuration Guides

Source: https://www.fecmall.com/doc/fecshop-guide/develop/cn-2.0/guide-fecshop-2-search-engine

Assistance guides for Fecmall, covering basic configuration, database setup, search engine integration, multi-language support, and Redis/MongoDB usage.

```APIDOC
## Fecmall Help and Configuration Guides

### Description
This section offers helpful guides for configuring and using Fecmall effectively. It covers essential setup tasks such as basic configuration, database service configuration, search engine setup (including Xunsearch), adding multi-language support, and utilizing Redis and MongoDB.

### Topics
- `Fecmall-基础配置`: Basic configuration settings for Fecmall.
- `Fecmall-Service数据库配置`: Configuring database services.
- `Fecmall-搜索引擎配置`: Setting up and configuring search engines.
- `Fecmall-添加多语言Store`: Adding multi-language support for stores.
- `Fecmall-使用redis`: Guide on using Redis with Fecmall.
- `Fecmall-使用Mongodb`: Guide on using MongoDB with Fecmall.
- `Fecmall-使用Xunsearch`: Guide on integrating and using Xunsearch.
- `Fecmall-Shopfw数据采集助理`: Using the Shopfw data collection assistant.
```

--------------------------------

### Fecmall Appserver API: Paypal Standard Start Request Example

Source: https://www.fecmall.com/doc/fecshop-guide/develop/cn-2.0/guide-fecmall-server-api-paypal-standard-start

Example JSON payload for initiating the Paypal Standard payment process via the Fecmall Appserver API. Includes return_url and cancel_url.

```json
{
    "return_url": "http://demo.fancyecommerce.com/#/payment/paypal/standard/review",
    "cancel_url": "http://demo.fancyecommerce.com/#/checkout/onepage"
}
```

--------------------------------

### Install Composer and Download Fecmall

Source: https://www.fecmall.com/doc/fecshop-guide/develop/cn-2.0/guide-fecshop-2-graphical-install

Steps to install Composer and download the Fecmall project using Composer. It includes commands for installing Composer, updating it, and creating a new Fecmall project. It's recommended to use Composer for easy upgrades.

```shell
curl -sS https://getcomposer.org/installer | php
mv composer.phar /usr/local/bin/composer
composer self-update
```

```shell
composer create-project fancyecommerce/fecshop-app-advanced  fecmall 2.1.2.1
cd fecshop
```

--------------------------------

### Initialize Fecmall

Source: https://www.fecmall.com/doc/fecshop-guide/develop/cn-2.0/guide-fecshop-2-graphical-install

Commands for initializing Fecmall after installation. This includes running an initialization script (`init.bat` for Windows, `./init` for Linux) to perform file copying and permission settings, enhancing security.

```shell
window: run init.bat
linux: run ./init
```

--------------------------------

### Fecmall Configuration Example

Source: https://www.fecmall.com/doc/fecshop-guide/develop/cn-2.0/guide-fecmall-api-product-image-sync

This snippet demonstrates a typical configuration setup in Fecmall, likely for database or API settings. It showcases key-value pairs and nested structures common in configuration files.

```php
<?php

return [
    'params' => [
        'adminEmail' => 'noreply@example.com',
    ],
    'components' => [
        'db' => [
            'class' => 'yii\\db\\Connection',
            'dsn' => 'mysql:host=localhost;dbname=fecmall_advanced',
            'username' => 'root',
            'password' => '123456',
            'charset' => 'utf8',
        ],
        'mailer' => [
            'class' => 'yii\\swiftmailer\\Mailer',
            'viewPath' => '@common/mail',
            'transport' => [
                'class' => 'Swift_SmtpTransport',
                'host' => 'smtp.mail.com',
                'username' => 'user@mail.com',
                'password' => 'password',
                'port' => '465',
                'encryption' => 'ssl',
            ],
        ],
    ],
];

```

--------------------------------

### Configure Nginx for Fecmall

Source: https://www.fecmall.com/doc/fecshop-guide/develop/cn-2.0/guide-fecshop-2-graphical-install

Example Nginx configuration for Fecmall, specifying document roots for different entry points like the PC frontend, admin panel, and image server. This allows Nginx to correctly route requests to the appropriate Fecmall application directories.

```nginx
server {
    listen 80;
    server_name www.fecshoptest.com;
    root /path/to/fecshop/appfront/web/;
    index index.php;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/var/run/php/php7.4-fpm.sock; # Adjust to your PHP-FPM version and socket
    }
}
```

--------------------------------

### Create Fecmall Project with Composer

Source: https://www.fecmall.com/doc/fecshop-guide/develop/cn-2.0/guide-fecshop-2-about-hand-install

This command uses Composer to create a new Fecmall project. It specifies the 'fancyecommerce/fecshop-app-advanced' package and a version number (which should be updated to the latest). It then navigates into the newly created 'fecshop' directory. This is the recommended way to download and set up Fecmall for easy upgrades.

```bash
composer create-project fancyecommerce/fecshop-app-advanced  fecshop 2.1.6
cd fecshop

```

--------------------------------

### Initialize Fecmall Database Migrations

Source: https://www.fecmall.com/doc/fecshop-guide/develop/cn-2.0/guide-fecshop-2-about-hand-install

Applies database migrations to set up the Fecmall database schema. This command should be executed from the Fecshop root directory.

```bash
./yii migrate --interactive=0 --migrationPath=@fecshop/migrations/mysqldb

```

--------------------------------

### Get Product List API Request Example

Source: https://www.fecmall.com/doc/fecshop-guide/develop/cn-2.0/guide-fecmall-api-product

Demonstrates how to make a GET request to the Fecshop product list API. It includes the URL, required headers like 'access-token', and optional query parameters for pagination and filtering.

```http
GET http://fecshop.appapi.fancyecommerce.com/v1/product/list?page=1&spu=kilw

Request Header:
access-token: YOUR_ACCESS_TOKEN

Query Parameters (Optional):
page: 1
third_refer_code: "some_code"
third_product_code: "product_code"
spu: "kilw"
```

--------------------------------

### Fecmall Appserver API

Source: https://www.fecmall.com/doc/fecshop-guide/develop/cn-2.0/guide-fecshop-2-graphical-bt-install

This section outlines the Fecmall Appserver API endpoints for managing user accounts, product information, cart, orders, and various checkout processes.

```APIDOC
## Fecmall Appserver API

### Description
Provides API endpoints for the AppServer, handling client-side operations such as user authentication, product browsing, cart management, and order processing.

### Endpoints
- `GET /api/status` (Get API status)
- `GET /api/captcha` (Get Captcha)
- `GET /api/home` (Get home page information)
- `GET /api/page` (Get page information)
- `GET /api/category` (Get category information)
- `GET /api/category/product` (Get products in a category)
- `GET /api/cart` (Get cart information)
- `POST /api/cart/paypal/start` (Start Paypal Express checkout)
- `POST /api/cart/paypal/review` (Review Paypal Express order)
- `POST /api/cart/paypal/submit` (Submit Paypal Express order)
- `PUT /api/cart/update` (Update cart information)
- `POST /api/coupon/add` (Add coupon to cart)
- `POST /api/coupon/remove` (Remove coupon from cart)
- `POST /api/onepage/init` (Initialize one-page checkout)
- `POST /api/onepage/change/country` (Change country in one-page checkout)
- `POST /api/onepage/submit` (Submit one-page checkout order)
- `POST /api/onepage/update/info` (Get updated information for one-page checkout)
- `POST /api/onepage/paypal/start` (Start Paypal Standard checkout)
- `POST /api/onepage/paypal/review` (Review Paypal Standard order)
- `POST /api/onepage/alipay/start` (Start Alipay Standard checkout)
- `POST /api/onepage/alipay/review` (Review Alipay Standard order)
- `POST /api/onepage/alipay/ipn` (Handle Alipay Standard IPN)
- `POST /api/onepage/checkmoney/start` (Start check money standard)
- `POST /api/payment/success` (Handle payment success)
- `GET /api/customer/account` (Get customer account details)
- `POST /api/customer/login/init` (Initialize customer login)
- `POST /api/customer/login/submit` (Submit customer login)
- `POST /api/customer/register/init` (Initialize customer registration)
- `POST /api/customer/register/submit` (Submit customer registration)
- `POST /api/customer/forgotpwd/init` (Initialize forgot password)
- `POST /api/customer/forgotpwd/sendcode` (Send verification code for forgot password)
- `POST /api/customer/forgotpwd/reset/init` (Initialize password reset)
- `POST /api/customer/forgotpwd/reset/submit` (Submit password reset)
- `GET /api/customer/address/list` (Get customer address list)
- `DELETE /api/customer/address/delete` (Delete customer address)
- `GET /api/customer/address/edit/init` (Initialize customer address edit)
- `POST /api/customer/address/edit/change/country` (Change country in address edit)
- `POST /api/customer/address/edit/submit` (Submit customer address edit)
- `GET /api/customer/order/list` (Get customer order list)
- `POST /api/customer/order/reorder` (Reorder customer order)
- `GET /api/customer/order/view` (View customer order details)
- `POST /api/customer/contacts/init` (Initialize customer contacts)
- `POST /api/customer/contacts/submit` (Submit customer contacts)
- `POST /api/customer/account/edit` (Edit customer account)
- `POST /api/customer/account/edit/submit` (Submit customer account edit)
- `GET /api/customer/wishlist/list` (Get customer wishlist)
- `DELETE /api/customer/wishlist/delete` (Delete product from wishlist)
- `POST /api/customer/product/review` (Submit product review)
- `GET /api/product/view` (Get product details)
- `POST /api/product/add/cart` (Add product to cart)
- `POST /api/product/add/wishlist` (Add product to wishlist)
- `GET /api/product/review/list` (Get product review list)
- `GET /api/product/review/add/init` (Initialize product review submission)
- `GET /api/product/search` (Search products)
- `GET /api/product/search/infinite` (Infinite scroll product search)
```

--------------------------------

### Fecmall API Response Structure and Example

Source: https://www.fecmall.com/doc/fecshop-guide/develop/cn-2.0/guide-fecmall-server-api-alipay-standard-start

Demonstrates the standard JSON structure for Fecmall API responses. It includes common fields like 'code' for status, 'message' for descriptions, and 'data' for detailed information. The example also shows a sample 'data' object with a redirect URL.

```json
{
    "code": 200,
    "message": "process success",
    "data": {
        "redirectUrl": "https://openapi.alipaydev.com/gateway.do?alipay_sdk=alipay-sdk-php-20161101&app_id=2016080500172713&biz_content=%7B%22out_trade_no%22%3A%221100000911%22%2C%22product_code%22%3A%22QUICK_WAP_WAY%22%2C%22total_amount%22%3A%22927.80%22%2C%22subject%22%3A%22Raglan+Sleeves+Letter+Printed+Crew+Neck+Sweatshirt+kahaki-xl%22%7D&charset=UTF-8&format=json&method=alipay.trade.wap.pay&notify_url=http%3A%2F%2Ffecshop.appserver.fancyecommerce.com%2Fpayment%2Falipay%2Fstandard%2Fipn&return_url=http%3A%2F%2Fdemo.fancyecommerce.com%2F%23%2Fpayment%2Falipay%2Fstandard%2Freview&sign=W3z2RHb%2BaC1NvaH8lg1Ug1G%2BRFQYW1yX%2FKaofsVopQp%2BAi84gFzL6%2FL85YnFJNy61X20o%2BObUqrQ5C5tbB5%2Bw%2F0IqXlJEkPAH%2FjVNZxyj2aqZBBPP2hY%2BQIyMVmbnQyEOXYlhYi2rhkVuPw%2BmFoJNFWkC5sSf8lQbOoKBFyljNkdnfelTxVliv7aCVuPsiKLMk6uKthwPv2KYJ9xMHM%2FH1panfC6ERHHwl8bUm6sxbD28vKmTLs5oB%2B%2BwCOreK8QdbE0VU9pK6mYpC6%2FwrTqZZEqUUou9WEOB1RVD%2B1L%2B3rroc0bL9Ru2SJbBhd3XE1B1B7MiR9N2qo3DlVjKr4Ifg%3D%3D&sign_type=RSA2&timestamp=2017-11-01+11%3A30%3A44&version=1.0"
    }
}
```

--------------------------------

### Fecmall Console API

Source: https://www.fecmall.com/doc/fecshop-guide/develop/cn-2.0/guide-fecshop-2-graphical-bt-install

This section details the Fecmall console commands and scripts for various tasks such as price calculation, inventory synchronization, data migration, and search index management.

```APIDOC
## Fecmall Console API

### Description
Provides access to console commands for managing product pricing, inventory, data synchronization between databases, and search engine indexing.

### Endpoints
- `product: calculate final price`
- `product: sync inventory data to product flat table`
- `product: sync category data from Mysql to Mongodb`
- `product: sync category data from Mongodb to Mysql`
- `sitemap: generate sitemap script`
- `url rewrite: generate script`
- `order: cancel pending orders script`
- `order: calculate product sales script`
- `search: delete all data from xunsearch script`
- `search: sync products to search script`
```

--------------------------------

### Fecmall-2.x Vue Installation - Environment Setup

Source: https://www.fecmall.com/doc/fecshop-guide/develop/cn-2.0/guide-fecshop-2-vue-install

This section details the required software and their versions for setting up the Vue frontend development environment on Windows.

```APIDOC
## Fecmall-2.x Vue Installation on Windows

### Description
This guide covers the installation of the Vue frontend for Fecmall 2.x on a Windows operating system. It includes setting up the necessary development environment.

### Method
Manual Installation

### Endpoint
N/A

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
None

### Request Example
None

### Response
None

### Environment Setup

1. **Required Software Versions**:
   - Python: 3.6.5
   - npm: 5.6
   - Node.js: 8.11.2

2. **Installation Steps**:
   * **Git Installation**:
     Download and install from the official website: https://www.git-scm.com/download/
   * **Python 3 Installation**:
     Download and install from the official website: https://www.python.org/downloads/
   * **Node.js Installation**:
     Download and install from the official website: https://nodejs.org/en/download/

3. **Version Verification**:
   Verify installed versions using the following commands:
   ```bash
   python --version
   npm -v
   node -v
   ```
   Expected output:
   ```
   Python 3.3.2 
   5.6.0
   v8.9.4
   ```

4. **NPM Version Downgrade (if necessary)**:
   If your npm version is not 5.6, you can downgrade it using the following commands:
   ```bash
   npm cache clean --force
   npm install -g npm@5.6
   ```

**Note**: After completing the Windows environment setup, refer to the documentation at https://github.com/fecshop/vue_fecshop_appserver for further instructions on installing the Fecshop Vue part.
```

--------------------------------

### Fecmall Appapi API

Source: https://www.fecmall.com/doc/fecshop-guide/develop/cn-2.0/guide-fecshop-2-graphical-bt-install

This section covers the Fecmall Appapi endpoints for managing multilingual properties, currency settings, page content, product attributes, categories, brands, and orders.

```APIDOC
## Fecmall Appapi API

### Description
Provides RESTful API endpoints for managing various aspects of the Fecmall e-commerce platform, including product information, categories, orders, and localization settings.

### Endpoints
- `GET /api/locale/get` (Get multilingual properties)
- `POST /api/locale/set` (Set multilingual properties)
- `GET /api/currency/get` (Get currency list)
- `POST /api/currency/set` (Set currency)
- `GET /api/page/list` (Get page list)
- `GET /api/page/fetchone` (Get single page)
- `POST /api/page/addone` (Add new page)
- `PUT /api/page/updateone` (Update existing page)
- `DELETE /api/page/deleteone` (Delete page)
- `GET /api/product/attribute/list` (Get product attribute list)
- `GET /api/product/attribute/fetchone` (Get single product attribute)
- `POST /api/product/attribute/addone` (Add new product attribute)
- `PUT /api/product/attribute/updateone` (Update product attribute)
- `PUT /api/product/attribute/upsertone` (Upsert product attribute)
- `DELETE /api/product/attribute/deleteone` (Delete product attribute)
- `GET /api/product/attribute/group/list` (Get product attribute group list)
- `GET /api/product/attribute/group/fetchone` (Get single product attribute group)
- `POST /api/product/attribute/group/addone` (Add new product attribute group)
- `PUT /api/product/attribute/group/updateone` (Update product attribute group)
- `PUT /api/product/attribute/group/upsertone` (Upsert product attribute group)
- `DELETE /api/product/attribute/group/deleteone` (Delete product attribute group)
- `GET /api/product/brand/list` (Get product brand list)
- `PUT /api/product/brand/upsertone` (Upsert product brand)
- `PUT /api/product/brand/upsertone-2` (Upsert product brand - alternative)
- `GET /api/product/brand/category/list` (Get product brand category list)
- `PUT /api/product/brand/category/upsertone` (Upsert product brand category)
- `PUT /api/product/brand/category/upsertone-2` (Upsert product brand category - alternative)
- `GET /api/product/list` (Get product list)
- `GET /api/product/fetchone` (Get single product)
- `POST /api/product/addone` (Add new product)
- `PUT /api/product/updateone` (Update product)
- `PUT /api/product/upsertone` (Upsert product)
- `PUT /api/product/upsertone-2` (Upsert product - alternative)
- `DELETE /api/product/deleteone` (Delete product)
- `POST /api/product/sync/image` (Sync product images)
- `POST /api/product/update/stock` (Update product stock)
- `GET /api/category/list` (Get category list)
- `GET /api/category/fetchone` (Get single category)
- `POST /api/category/addone` (Add new category)
- `PUT /api/category/updateone` (Update category)
- `PUT /api/category/upsertone` (Upsert category)
- `PUT /api/category/upsertone-2` (Upsert category - alternative)
- `DELETE /api/category/deleteone` (Delete category)
- `POST /api/category/sync/image` (Sync category images)
- `GET /api/order/list` (Get order list)
- `GET /api/order/fetchone` (Get single order)
- `POST /api/order/update/status` (Update order status)
- `POST /api/shopfw/product/add` (ShopFw tool: Add product)
- `POST /api/shopfw/product/update/stockprice` (ShopFw tool: Update product stock and price)
```

--------------------------------

### Configure Apache for Fecmall

Source: https://www.fecmall.com/doc/fecshop-guide/develop/cn-2.0/guide-fecshop-2-graphical-install

Example Apache VirtualHost configuration for Fecmall. This setup directs requests for different subdomains (like PC frontend, admin panel) to their respective web directories within the Fecmall installation.

```apache
<VirtualHost *:80>
    ServerName www.fecshoptest.com
    DocumentRoot /path/to/fecshop/appfront/web/
    <Directory /path/to/fecshop/appfront/web/>
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>
```

--------------------------------

### Fecmall Appfront 默认入口文件

Source: https://www.fecmall.com/doc/fecshop-guide/develop/cn-2.0/guide-fecmall-appfront-about

Appfront的默认入口文件，用于处理PC端浏览器的访问请求。它会加载一系列配置文件以完成应用初始化。

```php
<?php

// 默认入口文件：@appfront/web/index.php
// @appfront/web/index.php
```

--------------------------------

### Install Composer and Update

Source: https://www.fecmall.com/doc/fecshop-guide/develop/cn-2.0/guide-fecshop-2-about-hand-install

This snippet demonstrates how to install Composer globally on a Linux system using a curl command and then update Composer to the latest version. Composer is a dependency manager for PHP and is crucial for installing Fecmall.

```bash
curl -sS https://getcomposer.org/installer | php
mv composer.phar /usr/local/bin/composer
composer self-update

```

--------------------------------

### Fecmall Console Introduction

Source: https://www.fecmall.com/doc/fecshop-guide/develop/cn-2.0/guide-fecmall-appadmin-block-edit

Overview of Fecmall's console entry points and available scripts.

```APIDOC
## Fecmall Console Entry Points

### Description
This section details the Fecmall console entry points and provides descriptions for various scripts related to data synchronization, price calculation, and search index management.

### Method
N/A (Informational)

### Endpoint
N/A (Informational)

### Parameters
N/A

### Request Example
N/A

### Response
N/A

### Available Scripts:
*   **product: 计算最终价格的脚本** - Script to calculate the final price of products.
*   **product: 产品库存表库存数据同步到产品flat表的脚本** - Script to synchronize product stock data from the stock table to the product flat table.
*   **product: Mysql产品分类数据同步到Mongodb的脚本** - Script to synchronize MySQL product category data to MongoDB.
*   **product: Mongodb产品分类数据同步到Mysql的脚本** - Script to synchronize MongoDB product category data to MySQL.
*   **sitemap: 生成的脚本** - Script to generate sitemaps.
*   **url rewrite: 生成脚本** - Script to generate URL rewrites.
*   **order: pending订单取消脚本** - Script to cancel pending orders.
*   **order: 计算产品销量的脚本** - Script to calculate product sales.
*   **search: 删除xunsearch所有数据的脚本** - Script to delete all data from Xunsearch.
*   **search: 产品同步到搜索的脚本** - Script to synchronize products to the search index.
```

--------------------------------

### Fecmall API Introduction

Source: https://www.fecmall.com/doc/fecshop-guide/develop/cn-2.0/guide-fecmall-appadmin-block-edit

Overview of Fecmall's API entry points, including authentication, multilingual support, currency management, and various data management endpoints.

```APIDOC
## Fecmall API Entry Points

### Description
This section provides an overview of the Fecmall API. It covers authentication, handling multilingual attributes, managing currency, and detailed endpoints for managing pages, product attributes, categories, and orders.

### Method
N/A (Informational)

### Endpoint
N/A (Informational)

### Parameters
N/A

### Request Example
N/A

### Response
N/A

### Key API Areas:
*   **Login and Verification**
*   **Multilingual Attributes** (Get/Set List, Get/Set Properties)
*   **Currency Management** (Get List, Set Currency)
*   **Page Management** (List, FetchOne, AddOne, UpdateOne, DeleteOne)
*   **Product Attribute Management** (List, FetchOne, AddOne, UpdateOne, UpsertOne, DeleteOne)
*   **Product Attribute Group Management** (List, FetchOne, AddOne, UpdateOne, UpsertOne, DeleteOne)
*   **Product Brand Management** (List, UpsertOne)
*   **Product Brand Category Management** (List, UpsertOne)
*   **Product Management** (List, FetchOne, AddOne, UpdateOne, UpsertOne, DeleteOne, Sync Images, Update Stock)
*   **Category Management** (List, FetchOne, AddOne, UpdateOne, UpsertOne, DeleteOne, Sync Images)
*   **Order Management** (List, FetchOne, UpdateOrderStatus)
*   **ShopFw Tools API** (Product Add, Product Update Stock and Price)
```

--------------------------------

### API Response Status Codes and Examples

Source: https://www.fecmall.com/doc/fecshop-guide/develop/cn-2.0/guide-fecmall-server-api-checkmoney-standard-start

Details common API response codes and provides an example of a successful response structure.

```APIDOC
## API Response Codes and Examples

### Description
This section details the status codes returned by the API and provides an example of a successful response.

### Method
N/A (General Information)

### Endpoint
N/A (General Information)

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
None

### Request Example
None

### Response
#### Success Response (200)
- **code** (integer) - Indicates the success of the operation. 200 signifies success.
- **message** (string) - A human-readable message describing the outcome of the operation.
- **data** (array) - An array containing the data returned by the API. This will be empty if no data is relevant to the request.

#### Error Responses
- **1500012** (integer) - Unable to retrieve order increment ID from dbsession.
- **1500018** (integer) - Order not found.

#### Response Example
```json
{
    "code": 200,
    "message": "process success",
    "data": []
}
```
```

--------------------------------

### Fecmall Admin Module Development

Source: https://www.fecmall.com/doc/fecshop-guide/develop/cn-2.0/guide-fecmall-appadmin-developer

Guides and examples for extending and customizing the Fecmall Admin interface, including creating new modules and understanding the existing structure.

```APIDOC
## Appadmin Module Development

### Description
This section provides guidance on how to extend the Fecmall Admin panel. It covers understanding the existing module structure, overriding existing functionalities, and creating entirely new modules.

### Key Concepts
- **Overriding Functionality**: Learn how to modify Fecmall's default behavior by following the 'Fecmall Rewriting Functionality' guide.
- **Creating New Modules**: Develop custom features by creating new modules within the `appadmin` directory.
- **Understanding Module Structure**: Familiarize yourself with the `@fecshop/app/appadmin/modules` directory to grasp the organization of existing admin modules.

### Example: Creating a 'Person' Module
This guide walks through the step-by-step process of creating a new 'Person' module from scratch, demonstrating how to integrate custom functionalities into the Fecmall Admin panel.
```

--------------------------------

### Fecmall Architecture and Initialization

Source: https://www.fecmall.com/doc/fecshop-guide/develop/cn-2.0/guide-fecshop-2-search-engine

Explanation of Fecmall's architecture, configuration structure, and the initialization process for different components.

```APIDOC
## Fecmall Architecture and Initialization

### Description
This section delves into the architectural overview and initialization processes within Fecmall. It covers the system's structure, configuration details, and the step-by-step initialization of key components like the request URL and stores.

### Topics
- `Fecmall 架构简叙`: A brief overview of Fecmall's architecture.
- `Fecmall 配置结构`: Explanation of the configuration file structure.
- `Fecmall 初始化（全）`: Comprehensive guide to the Fecmall initialization process.
- `Fecmall 1.index.php初始化`: Initialization process starting from `index.php`.
- `Fecmall 2.Store初始化`: Initialization process for the Store component.
- `Fecmall 3.Request Url初始化`: Initialization process for handling Request URLs.
```

--------------------------------

### Fecmall Appfront 多Store入口配置示例

Source: https://www.fecmall.com/doc/fecshop-guide/develop/cn-2.0/guide-fecmall-appfront-about

展示了Fecmall Appfront如何根据Store配置加载不同的入口文件，例如为不同语言的Store设置独立的index.php文件。

```php
<?php

// 对于其他store的入口配置示例
// @appfront/web/fr/index.php
// @appfront/web/cn/index.php
```

--------------------------------

### Fecmall Structure and Initialization

Source: https://www.fecmall.com/doc/fecshop-guide/develop/cn-2.0/guide-fecshop-2-base-config

Explains the architectural overview, configuration structure, and the initialization process of Fecmall, including request URL handling.

```APIDOC
## Fecmall Structure and Initialization

### Description
Details the architecture of Fecmall, its configuration setup, and the step-by-step initialization process, including how request URLs are handled.

### Topics Covered
- Fecmall Architecture Overview
- Fecmall Configuration Structure
- Fecmall Initialization (Complete)
- Fecmall 1.index.php Initialization
- Fecmall 2.Store Initialization
- Fecmall 3.Request URL Initialization
```

--------------------------------

### Fecmall Appserver API Introduction

Source: https://www.fecmall.com/doc/fecshop-guide/develop/cn-2.0/guide-fecmall-appadmin-block-edit

Overview of Fecmall's Appserver API, covering client explanations, status codes, and various endpoints for home, page, category, cart, checkout, customer management, and product interactions.

```APIDOC
## Fecmall Appserver API Overview

### Description
This section details the Fecmall Appserver API, including explanations for the Vue client, API status codes, and various endpoints. It covers functionalities like retrieving home and page information, managing categories and products, handling shopping carts, processing orders (including different payment gateways like PayPal and Alipay), customer account management, and product interactions.

### Method
N/A (Informational)

### Endpoint
N/A (Informational)

### Parameters
N/A

### Request Example
N/A

### Response
N/A

### Key API Endpoints:
*   **Status Codes**
*   **Captcha**
*   **Home**: Get home page information.
*   **Page**: Get page information.
*   **Category**: Get category information and products within a category.
*   **Cart**: Manage shopping cart (get info, update, add coupon).
*   **Onepage**: Handle one-page checkout process, including country changes and order submission, with support for various payment methods (Paypal Standard, Alipay Standard, CheckMoney Standard).
*   **Payment**: Process payment success.
*   **Customer**: Account management (login, registration, password reset, address management, order history, contact information, account editing, product favorites, product reviews).
*   **Product**: View product details, add to cart, add to favorites, manage reviews, search products.
```

--------------------------------

### Get Fecmall Currency List (JSON)

Source: https://www.fecmall.com/doc/fecshop-guide/develop/cn-2.0/guide-fecmall-api-currency-list

This snippet demonstrates how to make a GET request to the Fecmall currency API to retrieve a list of currencies. It includes the necessary request header for authentication and shows an example of the expected JSON response.

```HTTP
GET http://fecshop.appapi.fancyecommerce.com/v1/currency

Header:
Authorization: Bearer <your_access_token>
```

```json
{
    "code": 200,
    "message": "fetch all currency success",
    "data": {
        "EUR": {
            "code": "EUR",
            "rate": "0.93",
            "symbol": "€"
        },
        "USD": {
            "code": "USD",
            "rate": "1",
            "symbol": "$"
        },
        "GBP": {
            "code": "GBP",
            "rate": "0.8",
            "symbol": "£"
        },
        "CNY": {
            "code": "CNY",
            "rate": "6.3",
            "symbol": "￥"
        },
        "JPY": {
            "code": "JPY",
            "rate": "104.02",
            "symbol": "JP¥"
        }
    }
}
```

--------------------------------

### GET /customer/address/index - Get Customer Address List

Source: https://www.fecmall.com/doc/fecshop-guide/develop/cn-2.0/guide-fecmall-server-api-customer-address

Retrieves a list of customer addresses. This API is used within the customer account section to display the user's saved addresses.

```APIDOC
## GET /customer/address/index

### Description
Retrieves a list of customer addresses. This API is used within the customer account section to display the user's saved addresses.

### Method
GET

### Endpoint
/customer/address/index

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
None

### Request Example
```
No request body is sent for this request.
```

### Response
#### Success Response (200)
- **code** (Number) - Return status code, 200 represents completion. Refer to Api- Status Code for complete return status code details.
- **message** (String) - Return status string description.
- **data** (Array) - Return detailed data.

#### Response Example
```json
{
  "code": 200,
  "message": "success",
  "data": [
    {
      "address_id": "1",
      "customer_id": "1",
      "address_label": "Home",
      "first_name": "John",
      "last_name": "Doe",
      "country": "US",
      "state": "CA",
      "city": "Los Angeles",
      "zip": "90001",
      "street1": "123 Main St",
      "street2": "Apt 4B",
      "telephone": "555-1234",
      "is_default": 1
    }
  ]
}
```
```

--------------------------------

### Fecmall Appfront and Apphtml5

Source: https://www.fecmall.com/doc/fecshop-guide/develop/cn-2.0/guide-fecshop-2-base-config

Provides an introduction and overview of the Fecmall Appfront and Apphtml5 components.

```APIDOC
## Fecmall Appfront and Apphtml5

### Description
Introduces and explains the functionalities of the Fecmall Appfront and Apphtml5 interfaces.

### Topics Covered
- Fecmall Front Introduction and Overview
- Fecmall Html5 Introduction and Overview
```
Tokens:
Raw