README

Yii2-Swap is module, that helps your users to swap different things.

Getting started with Yii2-swap

*** Alpha version v0.8.3-alpha ***

1. Download

Yii2-Swap extension can be installed using composer. Run the command bellow in console to download and install Yii2-swap:

composer require kirillantv/yii2-swap

or you can add following require to composer.json:

...
"require": {
  ...
  "kirillantv/yii2-swap": "*"
  ...
}

2. Configure

Add following lines to your main configuration file:

'modules' => [
    'swap' => [
        'class' => 'kirillantv\swap\Module',
    ],
],

3. Update database schema

The last thing you need to do is updating your database schema by applying the migrations. Make sure that you have properly configured db application component and run the following command:

$ php yii migrate/up --migrationPath=@vendor/kirillantv/yii2-swap/migrations

4. Available actions

Backend management actions

NOTE: It is not recommended to use actions below in frontend. Even swap/management/items/create action. All index pages designed as GridView by default

0. Simple start

You can get access to swap console easily with action below:

swap/management

1. Items

swap/management/items list of all items swap/management/items/create create item in module management page

2. Categories

swap/management/categories list of all categories

swap/management/categories/create create category

3. Bets

swap/management/bets list of all bets

swap/management/bets/create create bet in module management page

4. Orders

swap/management/orders list of all orders

swap/management/orders/create create order manually

5. Attributes

swap/management/attributes list of all attributes

swap/management/attributes/create create attributes for your items

6. Attribute Values

swap/management/values junction table for items and attributes

swap/management/values/create create manually junction between item and attribute. Just for specific solutions

7. Visual Configuration

swap/management/basic-configuration configurate module

Frontend actions

1.Items

swap/items input all active items

swap/items/create create item with attributes, categories and bets

swap/items/edit param id. Update form for item

swap/items/view param id. View form for item. Users can swap from this page.

2. Orders

swap/orders/create create order when user clicks swap button. Available to choose bet

User actions

Yii2-Swap provides user's items and orders output. You can add corresponding actions in profile menu or override views

1. Items

swap/user/items main action for user's items

swap/user/items/active user's active items

swap/user/items/archive user's archive items

2. Orders

swap/user/orders main action for user's orders

swap/user/orders/active user's active orders

swap/user/orders/archive user's archive orders

3. Messages

Attention! Message module is not stable.

Extension supports specific message system by the default. After migration in your DB swap_message table will appear. We need for prefix not to conflict with your chat or mail system. We included message model in default orders controller and view. But you can access to inbox and conversation using controllers bellow:

swap/message/inbox - list of all user's conversations grouped by item_id

swap/message/conversation - need for GET parameters: hash, item, from, to of any message from current user's conversation. So foreign user can't enter to conversation.