Multivendor Basic App Documentation

How to Create Cedcommerce Marketplace App

Introduction

Multivendor App converts "CedCommerce Magento Marketplace store to mobile shopping app", fully synchronized with cedcommerce marketplace to provide real time data with best user experience. Multivendor App will boost your revenue exponentially & will provide customer's best shopping experience and vendor's best shop management. Vendors/Sellers will be able to see their Dashboard, Manage Orders, Create Product and many more activities can be performed. This manual will explain step by step process to build and configure app.


Types Of Apps

We have two types of app which will cover all features of Cedcommerce Marketplace.

  • 1)Basic App

    Our Basic App provide following functionality.

    • Customization Of App
    • Add Launcher Icon
    • Add App Icon
    • Vendor Dashboard
    • Vendor Login
    • Vendor Registration
    • Vendor Profile
    • Create/Edit Product
    • Support Simple Product Creation/Editing
    • Support Virtual Product Creation/Editing
    • Manage Orders
    • Manage Transactions
    • Payment Settings
    • Product Report
    • Order Report
  • 2)Platinum App

    Our Platinum App provide fully featured cedcommerce platinum app features including vendor review & ratings, vendor product attribute, vendor social login and some other additional features. You can check below list for full platinum app features.

    • Customization Of App
    • Add Launcher Icon
    • Add App Icon
    • Vendor Dashboard
    • Vendor Login
    • Vendor Registration
    • Vendor Profile
    • Create/Edit Product
    • Support Simple Product Creation/Editing
    • Support Configurable Product Creation/Editing
    • Support Bundle Product Creation/Editing
    • Support Virtual Product Creation/Editing
    • Support Grouped Product Creation/Editing
    • Manage Orders
    • Manage Invoice
    • Manage Shipment
    • Manage Credit Memos
    • Manage Transactions
    • Payment Settings
    • Shipping Settings
    • Product Report
    • Order Report
    • Vendor Social Login
    • Vendor Review & Rating

App Installation

Once you buy multivendor app you can download connector module from "My Purchased Extension" tab in customer account section on our site MultivendorApps. There you can see a list of all purchased module. In order to download module first you will have to create license for your domain. You can create license by clicking on "Generate License For One Domain".

magenative_license
On clicking "Generate License For One Domain" you see a popup as shown in image below. There you have to enter your domain name.
magenative_licensepopup
Once you successfully generate the license you will be able to download your extension. You can get license information and download link on the same screen and you will also receive an e-mail on registered email id containing license information. The license key you received will be needed in order to activate your module. We will discuss that process later in this documentation. Screen containing license information and download link will look as in image below.
magenative_download
This module will help your magento shop to integrate with app. Once you install connector plugin and do little setup on plugin. Your app is now ready to receive api feeds from your magento shop.

Follow the below easy steps to install connector:-

1)Pre Installation steps

  • Step 1: Disable Compilation

    First of all check your compilation status by the System-> Tools -> Compilation if it is enabled, disable your compilation first.
    After installation you can again enable your compilation.

  • Step 2: Disable Cache

    Disable your entire cache from the System -> Cache Management menu from the admin site.
    After installation you can re-enable your cache.

  • Step 3: Backup Database (Optional)

    Before installation of the extension you can take backup of your database if any issue occurs during installation so you can revert back your database backup.

2)Installation Using Magento Connect

  • Step 1: Copy Extension Key

    To install the extension from the Magento-Connect you just need to go to the relevant page where the ced-mobiconnect extension exists. Then choose your platform & copy your extension key.

  • Step 2: Install Extension By Key

    Now go to the admin site of the magento site and go to the system ->Magento Connect ->Magento Connect Manager. Login to the downloader platform.
    Paste your key to the below highlighted area and click on install.

    multivendorinstall
    After clicking on install you will see the details of the extension with its version you can proceed and your extension will install in few moments.

3)Installation Using Package Upload

  • Step 1:

    When you purchased the extension from our official site you will get the full package of the extension. Go to the package downloader wizard (Magento Connect Manager).

  • Step 2:

    Go to the section “Direct Package File Upload” and browse for the package then click to the upload button. This will install the extension and you can monitor the progress in the console bottom area.

4)Installation using ftp

  • Step 1:

    If you have any issue in the installation process in the above two method you can use the native installation method by FTP. Connect your FTP and go to the root directory of the magento installation. Unzip our package which you get after purchase. You will get the two folders “Step 1” and “Step 2” Upload all the files of “step 1” to the root directory first after upload of the “Step 1” upload all the files of the “Step 2”.

5)Post Installation Steps

  • Step 1:

    When you are done with the installation of the extension you can logout your admin and re-login to the admin section

  • Step 2: Clear Your Cache

    Clear all the your caches first and if required can enable your cache.

  • Step 3: Enable Compilation

    If you need compilation enabled you can enable it again


Build your app

You can build your app from "My Apps" tab in customer account section on our site MageNative Building an app is a 4 step process. We will discuss each step one by one.

Step 1: Design

This step will decide the look and feel of your app. So in this step you need to provide basic information about your shopping app. Please fill in all the fields and click save to move to next step.

App designing screen can be found as below screen.

magenative_buildapp
  • App Name: The name of your app which you want to display in app
  • Domain Name: The domain of the store of which you want to generate app. If you purchased license for more than one domain then it will be select field otherwise the domain appears only as a label.
  • Base URL: The base url of the store of which you want to generate app. You can get your base url from system->configuration->general->web->Secure->Base URL from magento admin.
  • Package Name: The name of your app package. It should be unique and follow the syntax "com. Your_Domain_Name.App_Name".
  • Version: The version of your app. It should be in this format "1.0.0".
  • Header Hash Key: This is a autogenerated secret key. Make a note of it. You need it during configuraing module, Without it your app will not receive api feeds.
  • Main Category Image: This is the image which will be showed on category list page in app.
    Note: The image shows only if category banner is disabled or you didn't create any category banner.
  • Sub Category Image: This is the image which will be showed on sub-category list page in app.
    Note: The image shows only if parent category does not have any product and if you didn't upload any category banner image from admin.
  • Placeholder Image: This is the image which will be showed until your image does not loads.
  • Login Page Background Image: This is the image which will be showed in background on login page.
  • Logo: The logo of your app which will be displayed on top of the home page. It must be a ".png" file with a dimension of 1024 x 1024(width x height)px.
  • Logo Preview: This will show you the preview of the logo which you had uploaded in previous field for both android and ios app.
  • App Icon: The icon of your app which will be shown in main menu of your phone.It must be a ".png" file with a dimension of 1024 x 1024(width x height)px.
  • App Store Preview: This will show you the preview of the logo which you had uploaded in previous field for both android and ios app.
  • Splash Screen: The splash screen image of your app which will be displayed whenever your app is loaded. It must be a ".png" file with a dimension of 512 x 512(width x height)px.
  • Theme Color: This field will let you to decide the color of your app theme.You can easily select any color from color picker px.
  • APP Store Preview: APP store preview will let you to see how your splash screen looks with selected image & color combination.
  • Home Layout: This field will allow you to select layout for app home page. We will provide three different layout.

Step 2: Language

This step will allow you to define various text and labels coming in app in different languages so that when customer change store from app then they see various text and labels in default store language. You can change any text coming in app by downloading and replacing text with new text in "language.xml" file corresponding to language for which you want to change labels. Once you finshed editing upload the file again and click on save button on top right corner.

magenative_locale

Step 3: Preview

In this step you need to provide some details to enable various important functionality like "Social Login", "Google Cloud Messaging", "Google Analytics" etc. You need to enter details separately for android and ios app.

Preview image screen will look as in below image

magenative_sociallogin
  • APP Type: You can provide details for android and ios app separately by selecting "Android App" or "IOS App"
  • Facebook App Id: We need facebook app id so that you can use facebook login in your magento app. You can get facebook login from Facebook App ID. To get facebook app id follow the steps listed there.
  • GCM KEY: From here you can provide the gcm key in order to use google cloud messaging service in our app. You can get gcm key by signing up here GCM KEY and following the instruction given there.
  • GOOGLE MAP KEY: From here you can provide your google map key. We need this to show your store on google app which comes under contact us page in our app.
  • Google Service JSON: To use google analytics and google cloud messaging you have to upload the file. Click here Google Service JSON to create and download the Google Service JSON file.
  • IOS Account User: IOS Account User Name. This field comes only if you select "IOS" in app type field above.
  • IOS Account Password: IOS Account Password. This field comes only if you select "IOS" in app type field above.

Step 4: Go Live

This step will allow you to publish your google and ios app on respective store. You can publish your app either by your account or by using our account.

Live image screen will look as in below image

magenative_sociallogin
  • APP Type: You can provide details for android and ios app separately by selecting "Android App" or "IOS App"
  • Upload Type: From here you may select whether you want to publish your google or ios app on respective store by our or your account.
  • User: This field only comes if you want publish app by your account. This is your account name with which you want to publish your app on respective store.
  • Password: This is the password of your account with which you want to publish your app on respective store.
  • Title: This field will allow you to provide title for your app which shows on store.
  • Short Description: This field will allow you to provide short description for your app which shows on store.
  • Description: This field will allow you to provide description for your app which shows on store.
  • Site URL: This field will allow you to provide site url for your app which shows on store.
  • Support URL: This field will allow you to provide support url for your app which shows on store.
  • Logo: This field will allow you to provide logo for your app which shows on store.
  • Feature Image: This field will allow you to upload main feature image of your app which shows on store.
  • Feature Image For Slider: This field will allow you to upload multiple feature image of your app which shows in feature-slider on store. You can upload any number of image by clicking in images for slider link.

App Configuration

Once you are done with building app and connector installation you can configure various features of your app in connector. This section will explain you various ways to configure app using connector.

Configure Multivendor Basic App

Multivendor App converts "CedCommerce Magento Marketplace store to mobile app" very easily.

Activate Your Module

To activate your module you have to enter the license key which you received in App installation step in system->configuration->License Info section under "CEDCOMMERCE" tab.

multivendor_activate

Enable/Disable Multivendor Module

It is a yes/no type field which is used to enable or disable multivendor module.
To enable/disable module please go to System->Configuration->Marketplace App. You can set it up by changing value in below highlighted area from magento admin panel.

multivendor_enable

Note: If it is set to NO then your app will not receive api feed from magento site.

App Unique Key

We use this unique key to authenticate app with connector.You can get the app unique key from our dashboard.
To setup secret key please go to System->Configuration->Marketplace App. You can set it up by changing value in below highlighted area from magento admin panel.

multivendor_api

Enable/Disable Google Cloud Messaging

It is a yes/no type field which is used to enable Google Cloud Messaging on your app.
To setup new arrival product group please go to System->Configuration->Marketplace App. You can set it up by changing value from below highlighted area in magento admin panel.

multivendor_gcm

Note: If it is set to NO then Google Cloud Messaging functionality will not work.


Features Of Multivendor Basic APP

  • Customization Of App
  • Add Launcher Icon
  • Add App Icon
  • Vendor Registration
  • Vendor Login
  • Vendor Dashboard
  • Vendor Profile
  • Create/Edit Product
  • Support Simple Product Creation/Editing
  • Support Virtual Product Creation/Editing
  • Manage Orders
  • Manage Transactions
  • Payment Settings
  • Product Report
  • Order Report

Vendor Registration

Multivendor Basic APP will allow people to create vendor profile on your site and starts selling their products. Our app will allow to create vendor profile by providing some basic information from vendor registration form as shown in below image.

multivendor_registration
multivendor_registration

Vendor will not be able to log in into its account until admin approves the vendor account.

Vendor Dashboard

Multivendor Basic APP allow vendor to have a quick look of their recent Orders, Total Earning, Pending Transfers, Product Approvals, Product Sales and Performance of Shop by Sales Analytic Graph, Country wise (Map)Sales Report.

multivendor_dashboard
multivendor_profile
multivendor_profile
multivendor_profile

Vendor Profile

Multivendor Basic APP allow vendor to update its profile. From this section vendor can update various information related to its store like vendor profile picture, company logo , company banner, meta information etc.

multivendor_profile
multivendor_profile
multivendor_profile

Create New Product

Multivendor Basic APP allow vendor to create product from their vendor panel. Our basic app provide support for simple and virtual product means vendor can create simple and virtual product from our basic app. When vendor clicks on these vendor will see screen as in below image.

multivendor_producttype
The above screen allow vendor to select type of product which he want to create. After selecting product vendor will see a form as shown in below image.
multivendor_productform
The above form list all the attributes which is required to create product. After filling all the fields and submitting form the product will be created.

Manage Product

Multivendor Basic APP allow vendor to manage product from their vendor panel. Manage Product list's all the product which vendor creates whether its approved, pending or not approved. Vendor can also update its product information by clicking on product which will redirect him to product edit page which is same as product creation form with all the value prefield with respective product data. Manage Product Screen looks as in below image.

multivendor_manageproduct
Vendors can filter their product by entering the product Id, Date From, Date To and the Status of the product to filter the product.
multivendor_productfilter

Manage Order

Multivendor Basic APP allow vendor to view orders with detailed report including tax, discounts and multiple currencies support. The vendor can easily manage orders from his vendor panel from Manage Orders page which displays the list of all the vendor orders.

multivendor_manageorder
multivendor_vieworder
Our multivendor basic app also notify vendor by sending notification as soon as order for its product was placed by any customer from anywhere. Vendors can filter their orders by entering the order Id, Date From, Date To and the Order Status of the order to filter the order.
multivendor_orderfilter

Transaction

Multivendor Basic APP allow vendor to view all the transaction's history done with admin for their orders. This section will allow vendor to view all the details of the transaction from "Transaction Details" page which displays the Beneficiary Details, Payment Method, Transaction Type, etc.

multivendor_transactionlist
multivendor_transactionview
This section will also provide vendor the facility to request payment from admin just by clicking request payment button. Vendor will also be able to request payment for multiple orders at once.
Note : Vendor will not be able to request payment if this functionality is disabled from admin.

Report

This section allow vendor to see advanced report between certain interval of time. Vendor can see report of his order and product which gives him a quick estimate of how many orders where placed and for which product.

Order Report

Vendor can filter reports by day, month, year and Vendor Payment Status. Filtered Report will display Total Sales, Net Earned, Total commission, Total Products Count in each date, month and year.

multivendor_orderreport

Product Report

Vendor can also see Products Sales report between dates which will show total sales amount and quantity sold.

multivendor_productreport

Settings

This section allow vendor to decide active Payment Methods and its details for All Admin-Vendor Transactions. The methods activated by the vendor will be visible to the admin on Credit/Debit Account page.

multivendor_paymentsetting

Marketplace Page

This page displays the list of all the approved vendors with their public shop names and their Company Logo/Image, Customizable Banner Image, Customizable Grid Image/Logo and Meta Information.

multivendor_marketplacepage

Vendor Shop Page OR Micro site

MultiVendor APP provides dedicated shop page for every vendor which contains Profile Information and Product Collection. Shop logo and Banner will also be visible on this page along with Meta Information, Find us on Facebook link and Follow us on Twitter link. In other words, all the information that is being entered by the vendor at the time of account creation will be displayed on the Vendor Shop Page.

multivendor_vshoppage