Manual

Below, you can find description of all basic options from administration panel.

Login

To enter to administration, you should add to web address:’admin/’, e.g.: if adderss looks like:’http://example.com/‘, administration will be:’http://example.com/admin‘. On the site, you will see login screen. At the beginning, login and password are set as follows:
Login: admin
Password: admin

:admin_login_en.jpg

You can change it after login to administration. To do that, select from upper right menu settings link.

:admin_menu_next_logo_en.jpg

Settings modyfication

On settings page, you can set all basic data.
:settings_en.jpg

Setting page contains following fields:

  • Page title - content of this field will be displayed in browser’s stripe. It is important also for searchers - it will appear as title of your site.
  • Description - this field is used mostly by searchers. It will appear as description of the site in searchers.
  • Keywords - words connected with the site - mostly searchers use this field.
  • Slogan - slogan, which appears under logo.
  • Foot info - this information appears on the left side of footer, it can contain e.g. information about copyright law.
  • Login - login of administrator.
  • Password - password of administrator.
  • Information about new order sent to e-mail - if this field contains e-mail address, message about new order will be send to this e-mail.

Besides this basic information and the most important, on the right side of the page you can find panel with additional fields. They were divided into few tabs.

At the settings page, additional panel consists of following tabs:

  1. Options - with following fields:
    • Default language - choosing default language.
    • Styles template - you can choose template of style for page.
    • Administrator is able to see hidden pages and products - here you can decide if logged administrator will be able to see hidden pages and products (in client-side).
    • WYSIWYG editor - you can decide if WYSWIG editor should be displayed above short and full description while adding/editing page.
    • Display files from server in form - this option gives you possibility to hide all files in directory “files/” while editing page. This function is very useful when you have many files in this directory.
    • Change files name to page and product name - you can change file names to be the same as page or product name. For example if you have file “xyz.jpg” and page is named “abc”, then after adding this file to “abc” page, file name will be change to “abc.jpg”. Very useful option to recognize where file is linked.
    • Copy files selected from server - here you can decide if files selected from server should be copied, when you select “No” script will use oryginal file
    • Display text size option - this option gives you possibility to display links to change text size on pages.
    • Products on page - how many products will be displayed on one site (in client-side).
    • Elements per page in administration - how many items will be displayed on one site in administration.
    • Currency - currency of prices.
    • Searching in full description of products - here you can decide if searcher should check also full description of products.
    • Display expanded menu - here you can decide if left menu should be always display with subpages.
    • Inherit themes/templates from parent pages - here you can decide if themes and templates should be inherit from parent page.
    • Language parameter in URL - here you can decide if language code parameter should be display in URL address.
    • Display products from subcategories in parent category - here you can decide if products from subcategories should be display in main category.
  2. Pages - contains following fields:
    • Start page - set of page/subpage as main/home page (attention: firstly you should create this pages).
    • Page with basket - set page/subpage, where basket will be displayed.
    • Page with order form - set page/subpage, where order form will be displayed.
    • Page with regulations - set page/subpage, where regulations will be displayed.
    • Page with search results - set page/subpage, where search results will be displayed.

Pages management

After setting basic data on the page ‘settings’, it’s time to input content of pages. Together with edition, it is one of the most frequent activities. Menu with this options is placed below logo. It looks like tabs with icons. If it is needed they develope (pull-down menu).

:admin_menu_under_logo_en.jpg

After placing cursor over ‘pages’ tab, and selecting ‘new page’, you will go to adding new page/subpage form. Similar to page ‘settings’ it consist of two parts - basic information (left side) and additional panel - tabs on the right side, you can hide them by clicking on “Hide tabs” link.
Particular field in left side of the page means:

  • Name - name of page/subpage.
  • Short description - data entered here will be displayed in full description if its field will be empty. Short description is displayed also in list of subpages on parent page.
  • Full description - displays on detailed page.

Above ‘full description’ field is placed default editor.

:basic_editor.jpg

There is a possibility to change default editor for WYSWIG editor(see settings' modyfication), which appears also above ‘short description’ field.
Additional panel (on the right side) consist of 4 tabs:

  1. Options - contains following options:
    • Status - information if particular page/subpage should be visible or not.
    • Position - order of pages’ displaying. Page with lower position is displayed before page with higher position. You can use negative number.
    • Parent page - here you can select parent page for particular subpage. If page don’t have subpage, select ‘none’.
    • Menu - describe where (in which menu) page will appears.
    • Address - entering web address into this field means that the visitor will be automatically moved to the web page which address was entered.
    • Products - when this options is marked, it will be possible to add products to this site.
  2. View - contains fields:
    • Subpages - way of displaying subpages of particular page. You can choose between:
      • List (name, description) – subpages of particular page will be displayed as list with name and short description.
      • List (name, description, photo) - subpages of particular page will be displayed as list with name, short description and photo.
    • Template - template file (with tpl extension), which will be use for particular page.
    • Theme - theme file (with php extension, placed in “templates/themes/” directory), which define structure of the page.
    • Banner - graphic file, which will be displayed at the top of the page (below logo and slogan).
  3. Files - it is devided into following sections:
    • Select files from computer to upload - let you upload files from your hard drive to the server, select appropriate file (using select button). Additional fields describing photos:
      • Description - description displayed below photo,
      • Position - order of displaying photos (if there is more then one photo),
      • Thumbnail 1 - length of longer side of thumbnail displayed in subpages’ list,
      • Thumbnail 2 - length of longer side of thumbnail displayed in subpages’ detailed page,
      • Photo’s place - place where photo should be displayed (on the right/left side).
    • Select files from server to copy - the files’ list already exists on the server. After selecting files which should be added to created site, there will appear additional fields: description, position, thumbnail 1, thumbnail 2, photo’s place - they were described in previous paragraph.
  4. SEO - this data aren’t directly visible on the site, but are of great importance for searchers. You can find here following fields:
    • Page title - title displayed in browsers’ stripe, used also by searchers.
    • Meta description - contains description of the page, used by searchers while indexing site.
    • Keywords - words connected with pages’ topic, field used by searchers.

For example, page with inserted data can look like:

:page_form_en.jpg

After inserting data to page’s form, press “save »” or “save and go to the list »” button at the top or bottom of the page, also filling every form from tabs should ends by saving. Then you will see message about successful operation.

List of already created pages, you can see after pressing tab ‘pages’ in menu below logo. It will look like in the following picture:

:pages_list_en.jpg

Pages in this list are group according to types of menus. For every page you can see following information:

set fields - id, name.

editable fields - position (order of displaying), status (visibility of the page). After changing this fields, you have to press “save »” button in the top or bottom of the page.

field with icons - blue pencil icon leads to edition of the page, icon with red minus - deletes page, asking about confirmation (deleting of parent page means deleting all files, descriptions connected with page and its subpages).

Pagination it is division of text for pages. Especially it is useful when text is long.
To divide text for pages, execute following steps:

  • when you use basic editor (default), place cursor in full description field, where you want to divide text and insert [break] or press icon: :break_icon.jpg.
  • when you use WYSIWYG editor, place cursor in full description field, where you want to divide text and insert [break].

Effect of this, is visible on bottom part of the page and looks like the following picture:
:pagination_en.jpg

Pages preview

Quick.Cart tool consists of two parts: administration panel (visible only after login) and client-side (main part of the site, visible for every visitor). To give administrator a possibility to preview page before making it available for visitors, execute following steps:

  1. In administration on ‘settings’ page, select ‘options’ tab and there select ‘yes’ next to ‘Administrator is able to see hidden pages and products’ field.
  2. In list of pages, mark ‘status’ field next to pages you want to see their preview and press “save »” button. You can also set it for single page - press icon of blue pencil (go to edition of page) and in ‘options’ tab uncheck ‘status’ field.
  3. In the same browser, where you are logged in administration, open new tab with your page (on client-side). You will be able to see there also pages set as invisible. They are visible only for user logged in administration, normal user won’t be able to see them.

If you want to make particular site visible for every visitor, check ‘status’ field (similary as in 2. paragraph). Preview of pages give you a chance to check design, layout and content of page before being webcasted.

Languages management

In menu below logo, next to “Pages” tab, you can find another tab named “Languages”. It developes showing option “New language”. After clicking this link, you will see form of adding new language.
:new_language_en.jpg

You are going to fill in following information:

  • Language - name for creating language, it should consist of two letters according to standard iso 639-1 (see table)
  • Create language using - choose language which will be basic for new one.

After pressing “save»” button, new language is created. New language files are created in lang/, config/ and db/ directory. Files of database are empty at the beginning.
Before making new translations, check download section on our web site, maybe somebody have made translation you are looking for before, so you can only copy languge file to /lang directory.

Created language appears in list of all languages in administration, to see this list you should click on “Languages” tab in menu below logo.

:languages_list_en.jpg

Next to name of every language are placed two icons: with blue pencil - means edition of names and messages in particular language and with red minus - deletes particular language.

Now you should create pages in added language - choose proper languge from list placed in top menu on the right side, and create pages in this language.

After creating new language version in administration, you are able to set it also at client-side. It is enough to add somewhere on page links to languages. For example you can add it in “templates/container.tpl” file and links can look like:

<a href="?sLang=pl">polski</a>
<a href="?sLang=en">english</a>

Products management

Next step is to add products. This possibility gives you third tab from left - “Products”. After placing cursor over this tab and selecting ‘new product’, you will go to adding new product form.

:new_product_en.jpg

Fields placed on left side of the page means:

  • Name - name of product (it will be displayed also in title of page while viewing details of products).
  • Price - price of product. You can add numeric value or string. If you will add string then product will not be orderable.
  • Short description - short description of product, displays on page with list of products (client-site).
  • Full description - full description, displays on page with details of particular product.

Additional panel (on the right side) consist of 3 tabs:

  1. Options - contains following options:
    • Status - information if particular product should be visible or not.
    • Position - order of products’ displaying. Product with lower position is displayed before product with higher position. You can use negative number. “0” (zero) means alfabetical order.
    • Product’s availability - here you can set availability of the product, for example that it will be available for 24h.
    • Pages - here you can select page where product should be displayed (you can select more pages - hold ctrl key while selecting).
  2. View and SEO - contains fields:
    • Template - template file (with tpl extension), which will be use for particular product.
    • Theme - theme file (with php extension, placed in “templates/themes/” directory), which define structure of the page with product.
    • Page title - title displayed in browsers’ stripe, used also by searchers.
    • Meta description - contains description of the page, used by searchers while indexing site.
    • Keywords - words connected with pages’ topic, field used by searchers.
  3. Files - it is devided into following sections:
    • Select files from computer to upload - let you upload files from your hard drive to the server, select appropriate file (using select button). Additional fields describing photos:
      • Description - description displayed below photo,
      • Position - order of displaying photos (if there is more then one photo),
      • Thumbnail 1 - length of longer side of thumbnail displayed in products’ list,
      • Thumbnail 2 - length of longer side of thumbnail displayed in products’ detailed page,
      • Photo’s place - place where photo should be displayed (on the right/left side).
    • Select files from server to copy - the files’ list already exists on the server. After selecting files which should be added to created product, there will appear additional fields: description, position, thumbnail 1, thumbnail 2, photo’s place - they were described in previous paragraph.

After inserting data to product’s form, press “save »” or “save and go to the list »” button at the top or bottom of the page, also filling every form from tabs should ends by saving. Then you will see message about successful operation.

List of already created products, you can see after pressing tab ‘Products’ in menu below logo. It will look like in the following picture:

:products_list_en.jpg

In products’ list, you can see following information:

Set fields: id, name, pages (pages with which product was connected).

Editable fields: price, position (order of displaying), status (visibility of the page). After changing this fields, you have to press “save »” button in the top or bottom of the page.

Field with icons - blue pencil icon leads to edition of the product, icon with red minus - deletes product, asking about confirmation.

Products preview

Similar as you can make preview of pages, you can also make preview of products. To give administrator a possibility to preview product before making it available for visitors, execute following steps:

  1. In administration on ‘settings’ page, select ‘options’ tab and there select ‘yes’ next to ‘Administrator is able to see hidden pages and products’ field.
  2. In list of products, mark ‘status’ field next to products you want to see their preview and press “save »” button. You can also set it for single product - press icon of blue pencil (go to edition of page) and in ‘options’ tab uncheck ‘status’ field.
  3. In the same browser, where you are logged in administration, open new tab with your page (on client-side). You will be able to see there also products set as invisible. They are visible only for user logged in administration, narmal user won’t be able to see them.

If you want to make particular product visible for every visitor, check ‘status’ field (similary as in 2. paragraph). Preview of products give you a chance to check design, layout and content of product before being webcasted.

Orders management

“Orders” tab gives you possibility not only to manage orders, but also manage couriers and payment. After placing cursor over ‘orders’ tab, you will see list of following links:

Pending - displays list of orders with status set as ‘Pending’. It looks like table with columns the same as list of all orders (described below).

Carriers, New carriers - described below in section carriers management.

Payment, New payment - described below in section payments management.

After press “Orders” tab, list of all orders is displayed in clear table similar to the following:

:orders_list_en.jpg

Columns in this table means:

  • Id - identifier of order.
  • First and last name, E-mail, Telephone, Company - data connected with person who ordered.
  • Date - date of filling order.
  • Status - status of the order. You can change status of few orders at once by marking field placed next to status. Then you have to select from list next to “save »” button, status you want to, and push “save »” button.

Icons with blue pencil and red minus means as usually edition and deleting of the order.

Going to edition of particular order (press icon with blue pencil or name and surname of client), you will see page with details of this order.

:order_edition_en.jpg

In main panel are following fields:

  • First and last name, Company, Street, Zip code, Telephone, E-mail - data connected with person who ordered, they are editable.
  • Date - date of ordering.
  • Language - language version in which order was filled.
  • IP - ip address of computer from which order was filled.
  • Status - status of order, from list can be choose: pending, processing, finished, canceled. Default status is “Pending”.
  • Comment - comment added to order by client, it is editable field.

Next to this group of fileds, is additional panel which consist of one tab: “Products and payment”. Using it, you can:

  • Edit products from order - fields name, price and quantity are editable. You can modify them for example when client would like to order more of some products. You can also remove product from order. To do this, mark field ‘Remove’ next to this product.
  • Add products to order - below list of ordered products is placed link add product to order. After clicking it, empty fields are added. When you fill in following fields: id, name, price (this data should correspond with data fill in while adding product) and quantity, this product will be added to order.
  • Edit payment and delivery - fields id, name, price are editable. You can change data of delivery and payment after receiving order from client.

Every operation should end by clicking button “save »” or “save and go to the list »“. You can find it in top and bottom of page.

Payment management

Adding pages and products aren’t enough to make internet shop working. Important aspect of such business is the way of paying for ordered products. Payment options can be found in next two links from list which is displayed after placing cursor above tab ‘Orders’ - tabs ‘Payments’ and ‘New payment’.
Payment link displays list of all payment methods, showing:

  • Id - identifier of payment.
  • Name - name of payment.

Placed next to every payment method icons, means as usually edition and removing of particular payment.

:payments_list_en.jpg

New payment - it gives you possibility to add new payment method. It is necessary to add payment before adding carrier. Displayed form consist of one field:

  • Name - name of payment method. It will be displayed in client-side while ordering.

On the right is placed tab, where you should tick which carrier is possible (they have to be earlier defined) and set relation between delivery price and payment method. There are two ways of doing it:

- percentage - for example if you insert “10%” - it means that total price of delivery service will be higher about 10% toward to carrier price, when this payment method will be selected, “-10%” means accordingly that total price of delivery will be smaller about 10% toward to carrier price.

- value - for example if you insert “8” - it means that total price of delivery service will be higher about value of 8 toward to carrier price, “-8” total price of delivery service will be smaller about value of 8 toward to carrier price, when client select this payment method.

:payment_edition_en.jpg

Every operation should end by clicking button “save »” or “save and go to the list »“. You can find it in top and bottom of page.

Carriers management

Last sector which have to be set is connected with the way of delivering ordered products - ‘Carriers’ link and ‘New carrier’. They are placed under payment options and give you possibility to add, edit and delete carriers.


Attention !
To add carrier, you have to define earlier payment ways, because price of carrier can be dependent on payment.


After pushing ‘Carriers’ link, table with already added carriers will be displayed. It’s columns describe:

  • Id - identifier of carrier.
  • Name - name of carrier.
  • Price - price for delivery service.

Placed next to every carrier icons means edition (blue pencil) and removing (red minus) of particular carrier.

:carriers_list_en.jpg

Next link under ‘Carriers’ is ‘New carrier’. It gives you possibility to add new carrier by filling form.

:carrier_edition_en.jpg

In form are placed following fields:

  • Name - name of courier, which will identify it. This name will be displayed while ordering products in client-side.
  • Price - price for delivery service.

On the right is placed tab, where you should tick which payment method is possible (they have to be earlier defined) and set relation between delivery price and payment method. There are two ways of doing it:

- percentage - for example if you insert “10%” - it means that total price of delivery service will be higher about 10% toward to carrier price, when this payment method will be selected, “- 10%” means accordingly that total price of delivery will be smaller about 10% toward to carrier price.

- value - for example if you insert “8” - it means that total price of delivery service will be higher about value of 8 toward to carrier price, “- 8” total price of delivery service will be smaller about value of 8 toward to carrier price, when client select this payment method.

Every operation should end by clicking button “save »” or “save and go to the list »“. You can find it in top and bottom of page.

Files management

In menu below logo, next to the “Languages” tab, you can find another tab named “Files”. After clicking this link, you will see list of files added to pages and sorted by file name.

:lista_plikow_en.jpg

Files’ list gives you possibility to manage the files quickly and easily.

set fields - name, page title,

editable fields - description, position and photo’s place. When you change some data, click to “save »” button at the top or bottom of the page.

You can delete selected files by choosing files in “delete” column and after selecting click to “save »” button at the top or bottom of the page.

Some notes and advices

  1. In Quick.Cart it is possible to add pages in any levels, so you can add page, subpage, subsubpage.
  2. Check, if PHP version is higher then 4.3.3. It is required for correct working of application.
  3. Try not to add photos with too big size (don’t exceed size of 1600px x 1200px), because server may have problems with generating of thumbnails.
  4. Added photo or file shouldn’t be larger then 2 MB (default server limitation).
  5. If you want Quick.Cart to generate thumbnails properly check if gd 2.0 library is active on server.
  6. A lot of problems concern rights settings. Check if you have set correct rights(you will find it in section: upload script on server) to catalogues and files if:
    • photos and files don’t load,
    • data of pages/subpages don’t save.
  7. It isn’t allowed to delete “powered by Quick.Cart” link from footer of the site, it is breaking of the licence. Only if you buy this possibility, you can remove this link.
 
instruction.txt · Last modified: 2010/05/26 14:55