File Seller

From Joomseller Wiki
Jump to: navigation, search

Introduction

Purpose

This document supports customers of Joomseller in using the File Seller component.

Scope

  • www.joomseller.com
  • joomseller’s customers

Overview

What is File Seller?

File Seller is a Joomla 2.5 component. You can use this extension as a download system or an online store to sell digital contents easily. File Seller can work individually on Joomla without having to be supported by any 3rd party extensions. That means, you only have to download File Seller, install & configure it following our instruction; and then you have a perfect store system within 5 minutes. File Seller is specified for digital content provider website such as sites selling MP3, softwares, eBooks or images, etc. Try File Seller, you will see that this tool can replace other download components.

Especially, with the ability to display responsively on mobile devices, we believe that this is a very useful upgrade for your download site since smart handheld devices are becoming more & more popular. It can be easily seen that purchasing/downloading products online is done via handheld devices has been rising day by day, therefore, responsive ability is extremely essential. With File Seller, you don’t have to worry about this because File Seller is totally responsive.

Furthermore, File Seller uses ACL of Joomla to configure permission for its system. So now you can integrate File Seller with a membership component to provide a membership download system fast & easily.

File Seller Features

  • Modern Design: With File Seller version 2.0, you won’t feel uncomfortable when browsing products displayed on classic design style. And your customers no longer have to click too many times to view your product’s information.
  • Multiple Categories system: This is another helpful feature for you when creating multi-level categories for your products. You can decentralize your categories in tree – shaped structure without any obstacles caused by Joomla™.
  • Coupon Code System: You can provide discount code for your customers when buying your files. The coupon code can be defined by percent or total amount.
  • Multiple Templates system: This feature helps you to create an abundant product selling interface which is totally different in comparison with other websites. If you want to change File Seller’s interface, it is very easy:

You just need to copy folder: “components/com_zj_fileseller/templates/default” to “components/com_zj_fileseller/templates/yourtemplate” .

And then change the interface in folder “yourtemplate”. You are not required to know about programming. All needed is little experiences in using HTML & CSS and then you can customize your interface easily. At present, in the interface page for displaying products, we provide you with 2 layouts and 2 different displaying styles:

  • Default layout: displaying each product in a line and showing that product’s key information.
  • Thumbnail layout: displaying products as thumbnail, with price and “Add to cart” button.
  • Product management: File Seller allows you to upload files, description, addition information, gallery, change logs, showcase, quick links (documents, installation, live demo …), setup price, download restrictions, meta keywords, meta description, select sales services for products, select flat-form for products (Joomla™ 1.5 native, Joomla™ 1.6 native, Magento …), select additional packages.
  • Discount management: You can make discount for each product or set discount for all of your products (in general configuration section).
  • Flexible download restrictions: For paid documents, you can setup download restriction to un-limited (lifetime download), or limit download by time (once customers paid for the document, they can download the document in a time range), or by number of downloads (paid customers can only download the purchased documents in a number of times).y
  • Download link & attach to email: Support downloading by link and attached files via email so your clients can easily buy & download products without having to return your site.
  • Responsive Design: Support all browsers and devices, so now visitor can browse your site on a mobile and tablet devices and buy your products easily without any trouble.
  • Multi-payment gateways support: Currently, File Seller supports PayPal2CheckOut, PayLater and Moneybookers payment gateways. We will continue on working and adding more payment gateways for this product in the near future.
  • 'Order management: you can manage all orders in backend and can evaluate the number of orders or which products have the highest downloads.
  • Shopping cart system: Your customers can add multiple products to the cart and manage them (add/delete) before processing to check out to get download links.
  • Flexible configuration options: There are many configuration options which can be changed from File Seller Backend. That makes File Seller become a flexible extension. Some of the important configuration parameters are:
    • General Configuration: Setting general configuration for your File Seller system (We created a default configuration so when installing, you can change it yourself easily).
    • Email: Setting emails to send when customers order products, when they pay successfully for their products… you can use tags like {full_info}, {payment_method}, {order_name},…in email to get dynamic information for email.
    • Message: Displaying notification when customers pay successfully, or cancel their payment.
    • Permission & Integration: Mapping between fields on order form and JomSocial or Community Builder and setting permission for users.
  • JomSocial integration: Auto-fill fields on order form (first name, last name …) from data stored in JomSocial profile so that user won’t have to re-enter these essential data.
  • Community Builder integration: Auto-fill fields on order form (first name, last name …) from data stored in Community Builder profile so that user won’t have to re-enter these essential data.
  • jNews Newsletter integration: File Seller allows you to add user (who purchased your products) to a jNews Newsletter and you can send email to them when you have new update or new notice for those products.
  • SH404SEF plugin: Allows you to use friendly URL by SH404SEF component to SEO your products.
  • Social Share buttons: Users can share products with their friends through many social networks such as Facebook, Twitter, etc.
  • 100% MVC model: As you already know, Joomla does not use entirely MVC model, but for File Seller, it does. And if you are a developer, it is extremely easy to understand how to customize in both backend and frontend.
  • If you need a JomSocial Points redeem payment plugin, please click http://www.jazzerup.com/blog/item/jomsocial-points-to-sell-fil

How to use File Seller?

How to configure and setting?

Backend Diagram

User need step by step:

  • Install the File Seller
  • Manage plug-ins.
    • Each plug-in is used in many functions, so it is need to be initiated and configured at the first time, example, Payment plug-ins are used in payment method to help user to order product which have payment.
  • Configure File Seller Backend Elements
    • These elements are all configurations that are used in Frontend, Backend, Background services (such as email...)
    • Currencies: the currency system is used in Featured Thumbnail, Featured Default, Category Thumbnail, Category Default, Product-Preview, Product details…
    • Payment: payment plug-ins are very useful, users only have to active them.
    • Options: all options of File Seller.
  • Configure File Seller Backend Information
    • Categories: need to be configured for categories.
    • Coupons: need to be planned and configured for discounts in year
    • Packages: need to be added to products.
    • After-sales Services: need to be added to products.
    • Compatible Platforms: need to be added to products.
  • Configure Frontend view:
    • Configure user’s template.
    • Create File Seller menus (you can select menu type of “File Seller”).
    • Add File Seller modules to user’s template to help the website to be friendly in use.

Backend diagram

Backend Diagram

There are some main flows:

  • Admin set ups basic elements (view Configuration category).
  • Admin configures basic information (view Configuration category).
  • Admin manages Products, Featured, Currencies, Packages, Coupons, After-sales Services, Compatible Platform …
  • Admin manages Orders, Download-Logs …
  • Admin configuration: General, E-mail Configuration, Message, Permission.

Frontend diagram

Frontend Diagram


There are some main flows:

  • User views category to find products.
  • User views featured to find products.
  • User finds products through
    • Search
    • Select from category, featured …
    • Slider product …
  • User buys the product on site: add product to Cart-> order.
  • User check their products that they chose “My Cart” ”, where they can delete product, update quantity of products from cart.
  • Users check their orders through “My Orders”.

Screenshots

Frontend:

FileSeller Screenshot Full Page.jpg



Backend:

Fileseller Screenshot Backend.png

Configuration

File Seller Installation

Requirements

Server Requirements

File Seller has several system requirements as follow:

You have to ensure that your system has already installed, XML and Zlib-Support built into your PHP.

PHP should be compiled with support for https (openSSL) and cURL.

PHP Safe Mode should be turned off.

Client Requirements

File Seller can run well on major browsers such as: Internet Explorer (version 7+), Firefox, Chrome, Opera 9+, and Safari. JavaScript must be activated.

The client/browser needs to be capable of accepting Cookies and Cookies must be enabled.

Installation

Download

Download.png

After purchased our product, you’ll see the download link at File Seller product page:

[ http:// joomseller.com/joomla-components/files-documents-seller.html]


Please download the product package: “File Seller” as well as the “GeoIP Libraries”.

Note: If there is any problem, please contact us via E-mail: [../../VIETBRAIN/Desktop/Dich/contact@joomseller.com contact@joomseller.com].

Package Preparation

Unpack File Seller installation package that you downloaded to your computer. These are packages in File Seller:


Component


com_zj_filseller 2.0.0 j2.5.zip



readme.txt

Modules


mod_zj_fileseller_categories.zip

mod_zj_fileseller_cart.zip

mod_zj_filesellser_slider.zip

mod_zj_fileseller_ajax_search.zip

Plug-ins

Payment Plug-ins

plg_jspayment_2co.zip

plg_jspayment_moneybookers.zip

plg_jspayment_paylater.zip

plg_jspayment_paypal.zip



plg_system_js_loadjquery.zip

Component:

  • com_zj_fileseller 2.0.0 j2.5
    • The main store management component.

Modules:

  • mod_zj_fileseller_categories.
    • Display all categories in tree-shape.
  • mod_zj_fileseller_search.
    • File Seller Ajax Search is a searching module using Ajax technology. It helps to search products of File Seller faster and more easily.
  • mod_zj_fileseller_cart.
    • File Seller Cart help you to display products you added to your cart: number of products, product’s information…
  • mod_fileseller_slider.
    • Display popular products: you can choose new products or products in certain category.

Plug-ins:

Payment Plug-ins

  • plg_jspayment_paypal
    • Joomseller Payment – Paypal plug-in allows payments via PayPal.
  • plg_jspayment_2co
    • Joomseller Payment - 2Checkout plug-in allows payments via 2Checkout.
  • plg_jspayment_moneybookers
    • Joomseller Payment - Moneybookers plug-in allows payments via Moneybookers.
  • plg_jspayment_paylater
    • Joomseller Payment - Pay Later plug- allows payments via Paylater.


Other

  • plg_system_js_loadjquery
    • System - jQuery Library plug-in allows system to load jQuery; prevent jQuery and Mootools conflicts.

File Seller component Installation

Go to Administrator site => “Extension” => “Extension Manager” in the Top Menu.

In “Upload Package File” block, please Upload & Install our extensions:

  • Component: com_zj_fileseller 2.0.0 j2.5.zip: File Seller core component. This is required.
  • Plug-ins: plg_jspayment_paypal.zip, plg_jspayment_paylater.zip, plg_jspayment_2co.zip, plg_jspayment_moneybookers.zip => these are plug-ins to support payment methods when users order products. They are essential plug-ins.
  • Modules: mod_zj_fileseller_cart, mod_fileseller_slider, mod_zj_fileseller_search, mod_zj_fileseller_categories... they support displaying products on your site in different styles and make your site become more lively and beautiful.

Installation for Joomla Extensions

Language Installation

File Seller’s interface can be switched to different languages. Default language is English. To make File Seller able to run with different languages, please follow these steps:

  • Download & Installation new Joomla! Language File.
  • After installing your language, let say its xx-YY, you need to create the File Seller language file to your language by:
    • Copy this file: {site root}/language/en-GB/en-GB.com_zj_fileseller.ini
    • To: {site root}/language/xx-YY/xx-YY.com_zj_fileseller.ini
  • Then translate it to your language.

Note: Sometimes you need to change encoding type of language file to “UTF8 without Bom” (you can use notepad++ to change encoding type of the file).

If you want to change backend language, do the same with language in “administrator” folder.

  • Switch the global Language
    • For Joomla! 2.5: go to “Extensions” => “Languages Manager”, select the language of your choice and make it “Default” by clicking that icon in the toolbar. (File Seller should now pick up the correct language form its own language folder).

Language Installation

Manage plug-ins

Payment Plug-ins

Go to Extensions => Plug-ins Manager => type is “jspayment”

Fileseller Payment Plugins


After configuration, in the Order Checkout view, you can see:

Payment plugin frontend

plg_jspayment_paypal

This is a payment plug-in, it allows users to order your product via PayPal.

Go to Extensions => Plug-in-Manager => Type is “jspayment”.

Options:

Fileseller paypal plugin.png

  • Test Mode => set payment in test mode or live mode
  • Secure Mode => user Paypal secure response url
  • Paypal Account => your Paypal account
  • Merchant Image => your merchant image url
  • Payment Logo => url of Paypal logo to show in payment listing
  • Log IPN Data => log all payment information (yes/no)
  • Debug => save debug data (yes/no)
  • No Shipping => no shipping (yes/no)
  • Paypal button => Buy now button type, please look at this link to learn more about 'bn' type. Please do not change this if you do not know about it. https://cms.paypal.com/us/cgi-bin/?cmd=_render-content&content_ID=developer/e_howto_html_Appx_websitestandard_htmlvariables

plg_jspayment_2co

This is a payment plug-in, it allows users to order your product via 2Checkout.

Go to Extensions => Plug-in-Manager => Type is “jspayment”, then search for it.

Options:

Fileseller 2co plugin.png

  • Payment logo => url of 2Checkout logo to show at payment listing
  • Merchant ID => your 2Checkout Merchant ID
  • Secret Word => your 2Checkout secret word
  • Routine => multi page check out or single page check
  • Mode => set payment in test mode or live mode
  • Email Merchant => email (yes/no) when new merchant placed

plg_jspayment_moneybookers

This is a payment plug-in, it allows users to order your product via Moneybookers.

Go to Extensions => Plug-in-Manager => Type is “jspayment”, then search for it.

Options:

Fileseller moneybookers plugin.png
  • Payment Logo => url of MoneyBooker logo to show in payment listing
  • Merchant Email => MoneyBooker merchant email
  • Check MD5 Sign => more secure with MD5 sign
  • Secret Word => MoneyBooker merchant secret word
  • Log IPN Data => log all payment information (yes/no)
  • Debug => save debug data (yes/no)

plg_jspayment_paylater

This is a payment plug-in, it allows users to order your product via Pay Later.

Go to Extensions => Plug-in-Manager => Type is “jspayment”, then search for it.

Options:

Fileseller paylater plugin.png

  • Transaction ID => default transaction ID for Pay Later payment

Other plug-ins

plg_system_js_loadjquery

This plug-in is for avoiding conflict between jQuery & Mootools.

Go to Extensions => Plug-in-Manager => Type is “system”, then search for it.

Options:

Fileseller Payment Plugins

  • jQuery Version => choose the version of jQuery.
  • Remove Mootools Conflict => if there is any conflict between jQuery and Mootools, user can choose Yes to avoid the conflict.
  • Where to add => choose where the change will be applied.

Configure Backend elements

After installing File Seller component, you will need to create basic elements, setting basic information … before you could actually let it operate. The right steps would be:

  • Create basic elements: base elements are Currencies, After-sales services, Compatible Flatforms, Packages, coupons, categories.
  • Set basic information: setting default value for currency, configuration in option: general, email configuration, message, permission …
  • Configure modules: setting modules in installation package.
  • Configure plug-ins: setting plug-ins in installation package.

Configure Currencies

Currency is displayed in product’s description, when users buy a product. You have to create at least one type of currency for File Seller. All currency types are managed in “Currencies Management” panel.

Go to “File Seller” => “Currencies”.

Fileseller Currencies Management


If it’s first time you install File Seller, we created sample Currency data for you with US Dollar, Euro and Pound. You could setup a new currency of your own or edit our sample currencies.

Fileseller Currency Edit

Currency’s property:

  • Title => Currency’s title.
  • Code => The code of currency. USA, EUR, GBP, JPY …
  • Sign => The sign of currency. $, €, £, ¥…
  • Display by => Sign or code will be selected to display, such as 1000$ or 1000USA
  • At position => When display an amount of money, the currency’s sign should be placed to the left or the right of number. Such as: 1000$ or $1000.
  • Default => Select this currency as default

Configure Payment

Go to “File Seller=> Configuration => Payment Management

Fileseller payment plugins.png

Please view in II.2.1.Payment Plug-ins

Configure Options

Go to “File Seller=> Configuration => Options

General

Fileseller general config.png

  • Store Name, Social Sharing, Default Template…
  • File Upload Configuration: The file’s location for your products, please ensure to secure this folder with an .htaccess file.
  • Display Configuration.
  • Discount Configuration: The global discount for all products on the site, this is the percent number, use an integer value only.

Email

Which email templates are supported?

Fileseller Configuration


  • Store E-mail: Email address of website’s administrator
  • Store E-mail Name: Admin’s name.
  • Admin Notify E-mail: Admin’s notification email.
  • New Order Placed: Send an email to buyer and administrator when the buyer completed the order form.
  • Oder Activated: Send an email to buyer and administrator when the buyer completed the payment for his/her order.
  • Attach Files: Attach all files of all products to Order Activated email.


A sample of configuration email template

Email To Buyer: Thank You E-Mail Message.

Thank You E-Mail Message

  • E-mail Subject: The e-mail subject.
  • E-mail Body: The email’s body – this section allows all HTML tags, so please format your email in the HTML editor and paste it here. Besides the HTML, we support the key values such as:
    • {name}
    • {products}
    • {total_price}
  • Variable Pattern => each email template is supported with many items of “Variable Pattern”. You can add “Variable Pattern” to Subject and Body of email. File Seller will identify and replace them by a specific value.


Variable Pattern

Description

{name}

Name’s user

{products}

Products of Order

{total_price}

Total price of Order

{download_link}

Link download products

{active_link}

Link active

Message

Fileseller Message Config.png


  • Thank You Message Page.
    • Use URL => Yes to display Message URL
    • Message URL => If Use URL, please put here URL value
    • Message Title => The thank you message page title.
    • Message Content => The thank you message page content, allows all HTML tags, so please format your content in the HTML editor and paste it here.
  • Cancel Message Page.
    • Use URL => Yes to display Message URL
    • Message URL => If Use URL, please put here URL value
    • Message Title => The cancel message page title.
    • Message Content => The cancel message page content, allows all HTML tags, so please format your content in the HTML editor and paste it here.

Permission

FIleseller Permission Configuration

Beside the default Joomla Action like Create | Delete | Edit… We add the following actions for using Permission at frontend:

  • Free Download => allows you to configure which groups of people are allowed to download with product.
  • Purchase => allows you to configure which groups of members are allowed to purchase.

Configure Backend base information

Configure Categories

This section manages all categories of products. The Categories Management Panel can be accessed via “File Seller” => “Categories”.



Main View

Fileseller Categories Management

New/Edit View

Fileseller Category Edit

Main information:

  • Title => the title of category
  • Description => the description of category
  • Basic Option/Image => the image of category


Tips and Warning

Tips:

  • You must create categories before creating products.

Configure Coupons

This section manages coupons for products. The Coupons Management Panel can be accessed via “File Seller” => “Coupons”.


  • Main View

Fileseller Coupons Management

  • New/Edit View

Coupon Edit

Main information:

  • Code => Please enter the coupon code, this is the require value.
  • Title => Coupon Title.
  • Description => Coupon Description.
  • Discount => The discount value of this coupons, please enter right value and do not include any character.
  • Counts => The limitation numbers when use this coupon, default "0" is unlimited.
  • Products => Select products to assign this coupon, if using default “non-select” it will understand that coupon is assigned to all products.


  • Tips and Warning

Tips:

  • Each coupon will be created to prepare for discount time.

Configure After – Sales Services

This section manages After–Sales Services for products.

The After-Sales Services Management Panel can be accessed via “File Seller” => “After-Sales Services”.


  • Main View

Fileseller After Sales Management


  • New/Edit View

Fileseller After Sale Edit

Main information:

  • Title => Title of After-Sales Service
  • Image => Image of After-Sales Service
  • Description =>Description After-Sales Service

Configure Compatible Flatforms

This section manages Compatible Flatforms for products.

The Compatible Flatforms Management Panel can be accessed via “File Seller” => “Compatible Flatforms”.


  • Main View

Flatform Management


  • New/Edit View

Fileseller flatform edit.png

Main information:

  • Title => Title of Compatible Flatform
  • Image => Image of Compatible Flatform
  • Description =>Description Compatible Flatform

Configure Packages

This section manages Packages for products.

The Packages Management Panel can be accessed via “File Seller” => “Packages”.


  • Main View

Packages Management

  • New/Edit View

Fileseller Package Edit

Main information:

  • Title => The package name.
  • Price => The package price.
  • Note => More information about this package.

Integration

In here you can manage user’s information when they order product.

Integration Configuration:

  • Community Integrate: Integrate billing form with a profile/community component so when a user logged in to the site and order any product, he will not need to fill the form again, all registration info will be filled automatically from selected component.
  • Comment: Integrate comment component to allow user to post a comment/review for each product. Select "None" to disable comment on the product’s detail page.
  • Main View

Fileseller integration.png

Configure Frontend view

Configure website template

You have many website templates, each website template has many positions (that will display modules).

You need:

  • Configure a template for File Seller with proper positions
  • Make the template to default

Manage menus

Go to “Menu” => “Main Menu”

Fileseller Menu Management.png



Add new menu item => Select Menu Item Type => choose exist menu link of File Seller

Fileseller Menu Item


Tips:

  • When you configure menu options, you will see many options “Use Global”. The default global values are set by going to Components => File Seller => Configuration => Options => tab Display or view the guide at II.3.3.Configure Options.

Featured Thumbnail Layout

  • Display all products in thumbnail in “Featured” view.
  • You can configure values for this view such as changing the number of displaying column, image’s size, arranging & displaying pagination…

Preview: please view in the III.2.Frontend Manual .

Options:

Fileseller Featured Thumb Menu.png

  • Num Intro => Number of products to display with the small intro.
  • Columns => Set how many columns to use per row.
  • Thumbnail Width => Product thumbnail width to show on thumbnail page.
  • Thumbnail Width => Product thumbnail height to show on thumbnail page.
  • Secondary Order => Order that the products will be displayed in.
  • Pagination => Show/Hide Pagination support.

Featured Default Layout

  • Display all products in view “Featured” by default.
  • You can configure values for this view such as changing the number of displaying column, image’s size, arranging & displaying pagination…

Preview: please view in the III.2.Frontend Manual.

Options:

Fileseller Featured Default Menu.png

  • Num Products => Number of products to display in a page.
  • Secondary Order => Order that the products will be displayed in.
  • Pagination => Show/hide pagination support.


Category Thumbnail Layout

  • Allow displaying in thumbnail all products in which category.
  • Configure in backend: Select Category, Num Products, Secondary Order, Subcategories Products…

Preview: please view in the III.2.Frontend Manual .

Options:

524 × 126px


530 x 403px

  • Choose a Category => Choose a category from the list.
  • Show Category Description => Show/Hide Category description.
  • Num Intro => Number of products to display with the small intro.
  • Columns => Set how many columns to use per row.
  • Thumbnail Width => Product thumbnail width to show on thumbnail page.
  • Thumbnail Height => Product thumbnail height to show on thumbnail page.
  • Secondary Order => Order that the products will be displayed in.
  • Subcategories => Show/Hide the Subcategories.
  • Subcategories Products => Show/Hide the Subcategories Products.
  • Pagination => Show/hide pagination support.

Category Default Layout

Allow displaying in normal view all products in which category.

  • Configure in Backend: Select Category, Num Products, Secondary Order, Subcategories Products, Pagination.

Preview: please view in the III.2.Frontend Manual .

Options:

Fileseller Category Default Menu.png

  • Num Products => Number of products to display in a page.
  • Secondary Order => Order that the products will be displayed in.
  • Subcategories => Show/Hide the Subcategories.
  • Subcategories Products => Show/Hide the Subcategories Products.
  • Pagination => Show/hide pagination support.

My Cart

  • Display product’s information that user bought – user can add & update quantity in their cart.
  • View cart when products are added in view product-details.

Preview: please view in the III.2.Frontend Manual .

Options: configure basic values of a menu.

Fileseller cart menu.png

My Oders

  • Display all information of all orders that user ordered on site.

Preview: please view in the III.2.Frontend Manual.

Options: configure basic values of a menu.


Fileseller cart menu.png

Manage modules

We provide you with some modules displaying products to make your site beautiful and well-organized.

Go to Extensions => Module Manager

Fileseller Module Manage.png

File Seller Categories (mod_zj_fileseller_categories)

Categories module allows displaying categories of products, helps you know there are how many products in specific category.

To configure File Seller Categories module, go to Extensions => Module Manager => type is “File Seller Categories”


Preview:

Categories Module


Options:

Categories Module Config


  • Module Class Suffix => a suffix to be applied to CSS class of the module. This allows the individual module styling.

File Seller Cart (mod_zj_fileseller_cart)

File Seller Cart help displaying product’s information you bought: quantity & product’s name…

To configure File Seller Cart module, go to Extensions => Module Manager => type is “File Seller Cart”

Preview:

My Cart Module


Options:

Cart Module Config

File Seller AJAX Search (mod_zj_fileseller_search)

File Seller Ajax Search helps users to search for product easily & quickly. Search interface displays in Ajax style – very user-friendly.

To configure File Seller Slider module, go to Extensions => Module Manager => type is “File Seller AJAX Search”



Preview:

FIleseller Search Module Preview


Options: You can easily configure module’s values. We have detail instruction when you hover on each configuration.

Fileseller Search Module

  • Order by => Products will be ordered in chosen type.
  • Search input box caption => Text displayed in box search.
  • Number products per => Maximum number of products to be display in search result box.
  • Minimum character to search => Minimum number of characters you have to enter to search.
  • No matches caption => Caption to be displayed when there’s no match in search result.
  • No matches title caption => Title of Caption to be displayed when there’s no match in search result.
  • Show intro-text => Show/hide intro-text
  • Enable mouse scrolling => Disable/enable scroll.
  • Max Desc => Limit number of the characters for the product description.
  • Search area width (px) => Width of box result.
  • Search area Height (px) => Height of box result.
  • Thumbnail width => width of box search.
  • Thumbnail height => Height of box search.

File Seller Slider (mod_fileseller_slider)

File Seller Slider module allows showing products in a nice slider.

To configure File Seller Slider module, go to Extensions => Module Manager => type is “File Seller Slider”

Preview:

Fileseller Slider Module Preview


Options:

Fileseller Slider Module.png

  • Select Categories => Select categories that you want to display.
  • Select Products => Select product that you want to display.
  • Price => Show/Hide price of product.
  • Title => Show/hide title of product.
  • Linked Images => Show/hide link on image of product.
  • Show image => Show/hide image of product.
  • Linked titles => Show/hide link on title of product.
  • Mode => Define mode of slide.
  • Direction => Define direction of slide.
  • Number of product to display => Number of product to display.
  • Width of box => Width of the box
  • Height of box => Height of the box.
  • Rolling delay time => Time between two products, in miliseconds.
  • Animation time => Time of an animation, in millisecond.
  • Auto run slide => Defines auto run slide is auto or not

User manual

Backend manual

To understand about the backend manual, please see first:

Configure Categories

Please view in II.4.1.Configure Categories.

Configure Products

This manages all products. The Product Management Panel can be accessed via “File Seller” => “Products”.


  • Main View

Products Management



  • New/Edit View

Add general information.

Product Edit


  • Category => The category that this item is assigned to.
  • Subscriber => jNews Newsletter for this product. When a user bought this product, he/she will be subscribed to this list automatically. You can send a newsletter email to this list when you have new release version for this product.
  • Image => Choose an image for this product. This is the main product image, it will be shown on Product details page, Category and Featured page.
  • Document URL => The product document URL, this link will be shown on product details page to help visitors to read full document before buying this product.
  • Demo URL => The product live demo URL, this link will be shown on product details page to help visitors to see full demo of this product.
  • Compare URL => Please provide a link to compare this product with another related product, it could be an article, table listing.
  • Install URL => The product installation guide, this link will be shown on product details page to help customer to set up all files easily.
  • Gallery URL => The product gallery URL, it is an external link. The product details page provide you an image gallery lightbox. However if you have many images to show, please provide the product gallery url.
  • Ticket URL => The support ticket system, or support system for this product. It allows users to contact support service more easily.



Supports & Features

Product Support


  • After-Sales Services => All additional services you will provide to customer when buy this product. All these featured are defined in "After-Sales Services". You press Ctrl (Options on MAC) for multiple select.
  • Compatible Platform => Please select all Platforms/CMS versions for this product. All these listings are defined in "Compatible Platforms".

Information other

Product Information


  • Price => The price of this product, leave it blank or enter "0.00" for a free product.
  • Discount => Exclusive discount for this product, the product’s sub price will be based on this value when you set a global discount in "General Configuration".
  • Additional Packages =>Please select additional packages for your product, this is an optional value.
  • Limit => The download limitation type, select "No Limit" for lifetime download.
  • Number Downloads => The number of download limitation. User can't download anymore when he reaches this download numbers.
  • Number Days =>The limitation time for downloading this product. Users can't download product after that day. It is an integer value.

Add gallery:

Fileseller product gallery.png

  • Add more Images => Add image for gallery of product.
  • Title => Title’s image
  • Status => Status of image.
  • Image => Add image.
  • Remove => Remove image in gallery of product.


Add File

Fileseller product file.png

  • Add more File: add file for product.
  • Title: Title of file.
  • File Name: Name’s file.
  • Status: Status of file.
  • Remove: Remove file of product.


Add Change Logs

Fileseller product changelog.png

Add Change Logs: Add change logs for product. Each change log includes:

  • Version: Name of version.
  • Date: Date when upgrade version is released.
  • Description: Description of new version with change in features.
  • Published: Status of version.
  • Remove: Remove version from product.


Add Showcase

Fileseller product showcase.png

  • Add Showcase: Add Showcase for product.
  • Image: Image of showcase.
  • Link: Link of showcase.
  • Published: Status of showcase.
  • Remove: Remove showcase of product.

Add Quick Navigation

Fileseller Product Quick link.jpg

  • Add Quick Links: Add quick navigation for product.
  • Image: Image of quick link.
  • Link: Link of quick link.
  • New Tab: Open link with new tab.
  • Published: Status of quick link.
  • Remove: Remove quick link of product.
  • Tips and Warning

Tips:

  • With Add Files: you are only allowed to upload file types as set in “Allow Extensions”.
  • Add Change Logs: You must enter product’s version & default value is 1.0.0.
  • You MUST select categories for product.
  • Support & Features: you have to create After-Sales Services & Compatible Flatforms before entering this information for products.

Configure Featured

This section manages all products of Featured. The Featured Management Panel can be accessed via “File Seller” => “Featured”.

  • Main View

Fileseller Featured Management


  • Tips and Warning
  • You can remove one or more products from “Featured” view – This view helps you easily manage new products & highlight products of your store.

Configure Download Logs

This section manages download product information. Each download log has this information: Username, Email, Product, Last Download Date.

The Download Logs Management Panel can be accessed via “File Seller” => “Download Logs”.


  • Main View

Download Logs Management

  • Tips and Warning

Configure Coupons

Please view in II.4.5.Configure Coupons.

Configure Orders

This section manages information of all orders.

The Orders Management Panel can be accessed via “File Seller” => “Orders”.


  • Main View

Orders Management


  • New/Edit View

Order Edit

Main information:

  • First Name => buyer's first name of this order.
  • Last Name => buyer's last name of this order.
  • Email => buyer's email of this order.
  • Product
  • Total price => Total price of this order.
  • Payment method => Payment method type like PayPal, 2Checkout, Master Card, Bank…
  • Transaction ID => The payment transaction ID, if you don't have any transaction ID, please leave it blank or type "MANUALLY".


  • Tips and Warning

In view Order there’s link to products of order to help you easily view ordered product’s information. There’s also user who ordered products to help admin view their information.

Configure After – Sales Services

Please view in II.4.3.Configure After – Sales Services.

Configure Compatible Platforms

Please view in II.4.4.Configure Compatible Platforms.

Configure Currencies

Please view in [ II.4.9.Configure Currencies.]

Configure Packages

Please view in [ II.4.5.Configure Packages].

Option

Please view in [ II.3.3.Configure Option].

Frontend manual

To understand about the frontend manual, please see first:



Main View

Featured Thumbnail Layout

  • View on PC

Display all products in thumbnail in view “Featured”.

Fileseller Featured Thumb Layout


  • View on mobile

Filseller Featured Thumb Layout Mobile


  • Tips and Warnings

When you click on Add to Cart button or Preview button:

  • If products without packages: products will be automatically added to cart.
  • If products having packages: there will be a popup displayed to describe product’s general information: product’s title, image, price, packages to help you select packages you like & Add them to cart.

Featured Default Layout

  • View on PC

Display all products in view “Featured” by default.

Fileseller Default Layout

  • View on mobile

Fileseller Default Layout Mobile


  • Tips and Warnings

When you click on Add to Cart button:

  • If products without packages: products will be automatically added to cart.
  • If products having packages: there will be a popup displayed to describe product’s general information: product’s title, image, price, packages to help you select packages you like & Add them to cart.

Category Thumbnail Layout

Allow to display products in thumbnail & choose product from which category to display.

  • View on PC

Fileseller Categories Thumbnail Layout


  • Tips and Warnings

Display type similar with view Featured Thumbnail Layout.

Category Default Layout

Display products in normal view & choose product from which category to display.

  • View on PC

Filseller Category Default Layout


  • Tips and Warnings

Display type similar with view Featured Default Layout.

My Cart

Display product’s information of product purchased by users. Users can add & update quantity in cart.

  • View on PC

View cart when product is added in view product-details:

Fileseller My Cart


View cart when product is added in view product-Preview:

My cart lightbox.png



  • View on mobile

My cart mobile.png


Process check out.png


Process check out mobile.png


  • Tips and Warnings
  • Subtotal of products is calculated by the total price of products & total price of packages selected.
  • In cart you can update product’s quantity.

My Orders

Display all orders’ information that user ordered on site.

  • View on PC

My Orders

  • Tips and Warnings:
  • In this view customer can download all product’s packages of an order as a file .zip.
  • You can download each package of products by going to view order-details.

Sub pages

Product – Details

View product’s detail information: Title, description, images, gallery, change logs…

  • View on PC

FIleseller Product Details




Information Features:

Fileseller Product Features


Information Packages and Price: You can add packages for products when adding to cart. Package’s price will be added directly to product’s price.

Fileseller Product Packages


Quick Navigation:

Fileseller Product Quick Navigation


Information Change Logs: display information about versions, update date & description.

Fileseller Product Change Logs


Information Showcase:

Fileseller Product Showcase



  • View on mobile

Product Details View on Mobile

Product - Preview

  • View on PC

Fileseller Product Preview


  • Tips and Warnings
  • In this view you can add products to your cart & select packages of selected product.

Order – Details

Display detail information of an order: user who placed order, ordered products…

  • View on PC

Fileseller order details.png

  • Tips and Warnings
  • This view displays detail information of an order: user’s information ,coupons, discount, total price… & product’s information: title, image …

Modules

File Seller Categories

Please view in II.5.3.1. File Seller Categories (mod_zj_fileseller_categories)

File Seller Cart

Please view in II.5.3.2. File Seller Cart (mod_zj_fileseller_cart)

File Seller Ajax Seach

Please view in II.5.3.3. File Seller Ajax Search (mod_zj_fileseller_search)

File Seller Slider

Please view in II.5.3.4. File Seller Slider (mod_zj_fileseller_slider)

Customization manual

In this chapter, we will show you how to create a template for File Seller component.

Multiple Templates System

This component as well as all the components from Joomseller.com has multiple templates system. It means that you could create unique and differential templates and switch between them anytime you want.

So, how to create a new template, it’s very simple:

  1. Go folder “components/com_zj_fileseller/templates/”. You could see that there’s a folder named “default”, this is our default template.
  2. Duplicate folder “default” and give new folder a name call “your_template”. Make sure that all files in folder “default” are copied to folder “your_template”.
  3. Now you can go to “File Seller Control Panel” => “Configuration” => “General”. You can see in Template block, there’re “default” and “your_template” in Default template dropdown list. If you choose “your_template” our component will use “your_template” to display.

Now, you’ve already created a new template. And the best past is you could modify it in any way you like, if anything went wrong, you could always switch back to our default template.

Please see our next part to know how to create template as you want correctly and effectively.

Modify File Seller Template

Note before you do anything:

Customize Template

Tools

We highly recommend that you should use Firebug (plug-in for Firefox). It’s very useful tool. When you browsing a webpage, you could right click on any element (image, button, link…), choose “Inspect Element with Firebug”. You will see all the HTML & CSS resources, the CSS values that affect this element and where you could find those values too. Moreover, you could modify CSS values right on the browser to see how your page will be changed before actually edit it on CSS file.

''''How to customize correctly

We have template files and resources files. Template files have structure and resources files include style and images. You could modify resources file: edit CSS values, change image files as you want. Template files should be used only for reference about element information such as: name, type and CSS class.

Resources file

All our CSS files and images are stored in folder your_template/assets.

  • zj_fileseller.css => Common CSS file, the CSS for default of File Seller.
  • slimbox.css => CSS for page product details (view gallery of product).


Template file

All the templates files used for displaying at frontend are stored in folder your_template. The source codes in those files are a little bit complex, because they included PHP code. But you should easily spot the html structure there.

  • featured.php => template for view products on Featured and Category.
  • featured_thumbnail.php
  • category.php
  • category_thumbnail.php
  • product.default.php
  • product.thumbnail.php


  • cart.default.php => template for View Cart.
  • cart.php
  • cart.preview.php
  • cart_preview.php


  • order.form.php => template for View Order
  • order.php
  • order.preview.php
  • orders.php
  • message


  • product.php => template for View Product-details.
  • product_preview.php

Developer manual

All Components

Retrieved from "?title=File_Seller&oldid=879"