This is the old help for the products:

http://www.mewsoft.com/help/auction/

The software comes with only one theme for everything, for the Stores themes also comes with only one theme.

But you can add unlimited stores themes very easy.

To create a new store theme, just copy these templates:

Store.Default.Listing.html

Store.Default.ListingGallery.html

Store.Default.Theme.html

to another files, say you want to create a new theme called "River", so copy these files to:

Store.River.ListingGallery.html

Store.River.Theme.html

in the same View directory for every theme you have, for example Default/view folder.

Then customize these templates to any look you want.

After you finish, take a screen shot of your theme and name it as:

store.theme.river.png

Put that image in the theme/Default/images folder for every theme you have.

Your users will see this new theme and can selet it in their store settings.

right to left direction for languages like Arabic, Hebrew, etc. We already inserted the html code to

include this file in the widget Head but disabled by commenting it, all you need to include this

rtl style file is to include it, the default line of code like this:

<!--link rel="stylesheet" type="text/css" href="[plugin::Views]stylertl.css" /-->

all you need is to uncommet that line:

<link rel="stylesheet" type="text/css" href="[plugin::Views]stylertl.css" />

You can use this css file to overwrite any css code for your RTL themes.

The Head widget exists in the desgin module Widget editor, which exists in the folder:

theme/default/widgets.

The style file stylertl.css exists in the template editor in the desgin module with the theme templates

which exists under theme/default/views folder.

You will need also to set the language direction variable in the language module file General and the page direction, for this see this topic:

Arabic Translation and Display - Right to Left Display

[ widget::Weather(location="[ plugin::UserZip],[ plugin::UserCity],[ plugin::UserState],[ plugin::UserCountry]", default="37909", unit="f", cache="60") ::]

you can pass to the widget the location and a default location, the temperature unit, and the cash time.

The location is used if the user is logged in, the default location is used if the user is not logged in or no address set in the location.

Both the location and the default variables can be either the full location address cit, state, country, etc, or zip code.

The plugins above will be filled with the current user information if logged in and will be empty if no user is currently logged in.

This allows the widget to display the current logged in user are weahter information or a default location weather for none logged in users.

The cash variable (in minutes) set the time to cash results instead of getting the  weather informatin from the provider site (google, yahoo, etc), zero value for the

cash disable the cash. Set this to a resonable time (in minutes) to avoid blocking by the weather providers thinking it may be an attack to their systems.

The unit sets the temperature unit either "c" for Celsius or "f" for Fahrenheit.

Thanks

html code inside the Frontpage template, and finally jquery js code for initialization and settings in the Frontpage template.

Each widget has a header which contains a title and three icons, these icons for, collapsing the widget, hidding the widget, and ediing the widget

color.

Each widget has the following html code:

<li class="widget color-blue" id="widget_id" style="z-index: 2000;">  

                <div class="widget-head"><h3>widget_title</h3></div>

                <div class="widget-content "  style="z-index: 9999;">

                 widget_contents

  

                </div>
</li>

Each widget must have uniqe id in the li element, in the above example the unique id="widget_id", replace widget_id with a unique name

for each widget.

You set the widget_title and widget_contents to anything you want.

You can control each widget color by the preset color classes in the dashboard.css files, in the above html code you will find:

class="widget color-blue"

you can replace the preset css class color-blue by any other class from these preset classes:

color-red, color-blue, color-green, color-purpple, color-white, color-orange, color-yellow, color-gray, color-pink,  color-black
 

You can edit the file dashboard.css and add your own color classes and use them to change the widgets colors.

The Collapse icon in the widget header allows the users to collapse/expand the widget.

The Close icon allows the users to hide specific widget.

The edit/setting icon allows the users to change each specific widgets colors individually.

You can control each individual widget icons and editing colors by passing these settings in the dashboard init function in the Frontpage tempate:

widgetIndividual : {
                search : {
                    'movable': false,
                    'removable': true,
                    'collapsible': true,
                    'editable': true,
                    colorClasses : ['color-red', 'color-blue', 'color-green', 'color-purpple', 'color-white', 'color-orange', 'color-yellow', 'color-gray', 'color-pink',  'color-black' ]
                }
 }

In the above js code, you control the "search" widget by setting the options 'movable', 'removable', 'collapsible', 'editable' to either false or true.

the option "colorClasses" is array of color classes if the editable enabled that will be shown for the user to select from.

To set the options for two or more widgets, do not forget the comma after each widget setting, example:

widgetIndividual : {
                search : {
                    'movable': false,
                    'removable': true,
                    'collapsible': true,
                    editable: true,
                    colorClasses : ['color-red', 'color-blue', 'color-green', 'color-purpple', 'color-white', 'color-orange', 'color-yellow', 'color-gray', 'color-pink',  'color-black' ]
                },
                weather : {
                    'movable': false,
                    'removable': true,
                    'collapsible': true,
                    editable: true,
                    colorClasses : ['color-red', 'color-blue', 'color-green', 'color-purpple', 'color-white', 'color-orange', 'color-yellow', 'color-gray', 'color-pink',  'color-black' ]
                },
                langauge : {
                    'movable': false,
                    'removable': true,
                    'collapsible': true,
                    editable: true,
                    colorClasses : ['color-red', 'color-blue', 'color-green', 'color-purpple', 'color-white', 'color-orange', 'color-yellow', 'color-gray', 'color-pink',  'color-black' ]
                }
            }
 

In the above code the settings for three widgets search, weather, and language, you can change the settings for each widget individually as you like.

Webawy Installation

Webawy Installation Steps.

1. You can use our Auto Installer to upload installation files to your server, skip to step 10 in this case.
   
   
2. Download webawy.zip to your local computer or server from our site using your license number from the Clients Area.
   
   
3. Extract the file webawy.zip to a folder on your local computer.
   
   
4. If you downloaded and extracted direct to your unix server you may need to run dos2unix on the extracted files.
   
   
5. Upload all the extracted files to your server in the correct  mode (*.js, *.cgi, *.pm, *.php, *.htaccess, *.html in ASCII mode)
   and all other images files in Binary mode using  your FTP program
   to a the folder you want normally called "app" off your public_html or httpdocs or htdocs or to the root html
   folder, you can install under any folder you want or even under the site root folder.
   
   Eexamples for installation folders on your server:
   
   /public_html/app
   
   /httpdocs/app
   
   /htdocs/app
   
   /www/app
   
   
6. Change permissions to 755 or web executables for the uploaded files *.cgi, *.pm, and .htaccess in all folders.
   
   
7. Point your browser to the file webawy.cgi to execute it, assuming you uploaded to the /app/ folder:
   
   http://www.yourdomain.com/app/webawy.cgi
   
   
8. This is the webawy compressed self extract installer file, once you call webawy.cgi you will see
   the installer page. Set the installer options and click the install button and wait until it finish.
   
   
9. Once the installer finish creating folders, extracting and installing all files, it will show a link at the bottom of the page
   pointing to the program configuration, click on that link to go to the configuration.
   
   
10. You can access the program configuration direct after installation using the link:
    
    http://www.yourdomain.com/app/admin/module/Configuration
    
    this assuming your installation folder is app, change it in the url above and use your real domain name.
    
    
11. Go to your site control panel say cPanel, Plesk, etc and create a mysql database and create a database user
    then add that user to the database and give it full privilages.
    
    
12. In the Webawy Configuration, click on the "Database" tab and setup your database information.
    
    
13. In the Configuration, click on "Setup" tab then click the link "Create SQL Database Tables" to create the database tables.
    
    
14. In the Configuration, click on "Setup" tab then click the link "Restore SQL Database From The Text Files Backup" to load the database defaults.
    
    
15. To reset the database stats, click on Modules, then click on the Stats module, then click on the link "Update All System Statistics".
    
    
16. Now you can access your website from the user side by calling the link:
    
    
    http://www.yourdomain.com/app
    
    
    of course if you installed on the root folder you should use the link:
    
    
    http://www.yourdomain.com
    
    
    
17. If you finished the above steps successfully then congratulations you have finished the installation and configuration.
    
    

Thank you

The Banner Manager documentations for all products except Auctionawy 2012 is here:

http://www.mewsoft.com/help/auction/Banner_Manager.html

Auctionawy Since Version 2012 Banner Manager

Since Auctionawy version 2012 released, we used gadgets to call banners instead of classes, the code to call banners in any template is:

[gadget::Banner(zone="zone name here", campaign="optionally campaign namer here or leave blank to rotate all zone campaigns")::]

for example:

[gadget::Banner(zone="Top_468", campaign="")::]
 

this will rotate all campaigns added to the zone Top_468.

All our products are html templates based, this means customization is done completely by editing those html templates and do not need to edit any program code files or do any kind of code programming. since these html template are pure html code containing some special tags as a place holders for the program output, then you can use any visual html editor to customize the templates and the layout to your look and feel. The only requirement for the visual html editor (like old versions of MS Frontpage) is to disable any feature if it exists that disables comments tags or disables Javascript tags which simply converts the left bracket tag "<" to the html equivalent "&lt ; " and converts the right bracket tag ">" to "&gt;", these two tags if converted will disable the JS code and will disable the program output which is inserted in the templates at place markers inside comments tags.

Templates Customization

Templates are html files and the program output is inserted into these templates by place markers inserted at the desired locations. Templates (or views) files are located in the themes views folders. There are many types of those place marker.

Templates Place Markers

The html templates contains many types of place markers for inserting the text for different translations and output data like plugins, widgets, gadgets, embedded Perl code, and listing blocks.

Language Markers Tags

Since all our products supports multi-lingual, the language text is inserted in the templates by markers called language variables, the language variables are marked by left and right curly brackets in the following form:

{language_variable_name}

and the text for that language variable is located in the appropriate language file.

Plugins Markers

Templates contains the Plugins markers or tags in this form:

[plugin::Home]

this plugin tag will insert the link to the site home link like http://www.mewsoft.com/

Plugins tags are used for dynamic program output. The program uses these plugin tags to insert its output at the locations they exist in the templates. So you can move these plugins tags any where you want in the templates or you can even remove them from the templates based on your needs. Plugins either general plugins that can be used in any templates like the plugins used for creating the navigation links, or private plugins which can be only filled with contents on specific templates, therefore you will find on some templates a plugins specific to their output only if you used it on other templates will not be replaced.

Widgets

Widgets are simply small blocks of templates can be used on one or more templates. Widgets files are the same as templates files everything on the templates applies to the widgets. Widgets files exists in the theme widgets folder and they have the same .html extension. If you have a block of html code that you want to repeatedly use it on many templates, you just put it in a widget file then call that widget inside any templates you want instead of copying the same code inside the tempates. For more details read Widgets API.

Widgets are called in the following form:

[widget::widget_name (arg1="value1", arg2="value2", arg3="value3", ,,,, arg_n="value_n")::]

Examples for the widgets are:

[widget::Head::]

[widget::Header::]

[widget::WelcomeArea::]

[widget::LogoArea::]

[widget::TopNav::]
 

Gadgets

Gadgets are Perl code modules that you can call direct form the templates or widgets to perform some tasks on the database or dynamic data or process anything on the server inside the application context then display the results in the templates. For more details read Gadgets API.

Calling this gadgets from your templates or widgets like this:

[gadget::gadget_name(arg1="value1", arg2="value2",...)::]

or use the shortcut:

[g::gadget_name(arg1="value1", arg2="value2",...)::]

you can pass any number of arguments with their values to the gadgets like you call functions in most programming languages.

Embedding Perl code inside html templates and widgets

You can write Perl code direct inside the html templates (views) and widgets. The embedded Perl code will run within the application context so you have direct access to all the application database connection, all global variables and functions, access to your entire server allowed resources, you embed Perl code as you write any Perl script and the Embedded Perl parser will run this Perl code snippet and will capture its output and insert it in the place holder specified by the code. For more details read Embedded Perl code in templates and widgets.

Embedded Perl code is inserted inside templates and widgets in this format:

Listing Blocks

Some templates may contain another type of marker tags, the listing blocks markers are used to mark the beginning and ending of an html 

code block used to list a repeated data rows.

Example for the listing block:

	

		Code: HTML    Select All    
	
	

		

			<!--block::listing_row-->



   <a href="<!--Link-->" _mce_href="<!--Link-->"><!--Photo--></a>

   <a href="<!--PreviewLink-->" _mce_href="<!--PreviewLink-->" class="preview-link" title="{preview_item_link_title}"><span class="ui-icon ui-icon-newwin" style="float:left; margin:0px; padding: 0px;" _mce_style="float: left; margin: 0px; padding: 0px;"></span></a><a href="<!--Link-->" _mce_href="<!--Link-->"><!--TitleBold--><font color="&lt;!--TitleColor--&gt;"><!--Title--></font><!--TitleBold1--></a> <!--New--><!--Featured--><!--Gift--><!--Hot--><!--Cool--><!--Buy--> <!--SellerCountryFlag--> <!--SubTitle-->

   <!--Quantity-->

   <!--Currency--> <!--CurrentBid-->

   <!--Bids-->

   <!--HighBidder-->

   <!--Duration-->



<!--::block-->




		
	

As you see the listing block starts with the marker <!--block::listing_row--> and ends with the marker <!--::block-->.

The program will parse this code block from the template and will use it to list the items and will output the result at the same location.

Embeded Perl Code API

Begaining with Auctionawy 2012 version 15.00 a new API integration tools implemended.

The new version API includes Widgets, Gadgets, Embeded Perl code, new templates tags, new template parsing etc.

Embeding Perl code inside html templates and widgets
===================================

Imagine now you can write Perl code direct inside the html templates (views) and widgets.

The embeded Perl code will run within the application context so you have direct access to all

the application database connection, all global variables and functions, access to your entire server

allowed resources, you embed Perl code as you write any Perl script and the Embeded Perl parser

will run this perl code snippet and will capture its output and insert it in the place holder specified by the code.

Embeded Perl code is inserted inside templates and widgets in this format:

Code: HTML    Select All

[perl::]  # your perl code goes here [::perl]

To skip a block, put ! in front of it like that !

Code: HTML    Select All

[perl::]...[::perl]

Gadgets Output
===========
All gadgets output must be printed to the stdout with the regular print function. This output will

be captured by displayed at the same location in the templates.

Do Not Return values from the gadgets as these values will be ignored, to display anything you

have to print it to the stdout.

Since your embeded code will run in the application context then all the application functions and

modules can be called and used.

Simple Example

===========

A simple example for embeded Perl code, say you want to display a message with the current logged in username,

Here is the code that you use inside the templates or widgets:

You can write any code short or long simple or complex the embeded parser will grap anything between the

Code: HTML    Select All

[perl::] and [::perl]

tags.

If your Perl code has any errors the program will not exist and will display the error messge received

for you to debug and fix your code.

Begaining with Auctionawy 2012 version 15.00 a new API integration tools implemended.

The new version API includes Widgets, Gadgets, Embeded Perl code, new templates tags, new template parsing etc.

What are Gadgets
=============

Gadgets are Perl code modules that you can call direct form the templates or widgets to perform

some tasks on the database or dynamic data or process anything on the server inside the application

context then display the results in the templates.

Calling this gadgets from your templates or widgets like this:


[gadget::gadget_name(arg1="value1", arg2="value2",...)::]

or use the shortcut:

[g::gadget_name(arg1="value1", arg2="value2",...)::]

you can pass any number of arguments with their values to the gadgets like you call functions in most
programming languages.

Gadgets files
=========
Each gadget is one perl module file .pm in the gadgets folder in the main application directory structure.

The gadget file name must be the same name as the gadget plus the extension ".pm".

For example to create a gadget called "hello" then you must create the module file "hellp.pm" in the gadgets

folder. The gadget file must have a Perl function called the same name as the gadget name "hello" in this example

so the gadget file hello.pm should looke like this:

sub hello {

my (%args) =@_;

   #Your code goes here
   # the hash array %args contains all the arguments passsed from the call in the template or widgets

}

1;

You will find many gadgets files in the gadgets folder and there is a demo gadget called NewGadget as a template

for gadgets you can copy it and modify to what you need.

# call this gadget from your templates or widgets like this:
#
# [gadget::NewGadget(arg1="value1", arg2="value2",...)::]
#
#==========================================================
sub NewGadget {
my (%args) = @_;
   
    # your code goes here. your code will run within the program context and
    # all the program variables and database connections are available for you.
    # $dbh variable hold the current sql database connection.
    # %Global array holds all the program configuration and settings.
    # %Param array holds all the browser query and forms data.
    # %Cookies array holds current session cookies.
    # %Plugins array holds any output code for redering plugins.
    # URL variable:
    # $Global{BaseUrl}, $Global{ProgUrl}, $Global{AdminUrl}
    # Folders variable:
    # $Global{BaseDir}, $Global{ThemeDir}, $Global{LangDir}
    # see the module file Configuration.pm for more variables and settings
    # to load and translate a view or gadget:
    # $view = &getView("my-view-or-widget-file-name-without-extensioin");
    # do your stuff with the view
    # to print and render the view to the user screen:
    # print $view;
    # do not return your output, just print it and it will be caught and inserted
    # where you called the gadget in your views or widgets.
  

   $out = "";

    while (($k, $v) = each %args) {
        $out .= "$k = $v";
    }

   # return the gadget output, do not print to browser or stdout direct.

   return $out;

}#end sub
#==========================================================
1;

As you see, the gadget function must return all its output and do not print direct to the browser or to the STDOUT etc.

The gadget output is insert where the gadget tag inserted inside the template, therefor it has to return any output and not

to print direct to the output.

Please browse the gadgets folder for many default gadgets that comes with the products.

Thank you

Begaining with Auctionawy 2012 version 15.00 a new API integration tools implemended.

The new version API includes Widgets, Gadgets, Embeded Perl code, new templates tags, new template parsing etc.

What are Widgets
=============

Widgets are small templates blocks which can be used in one or more templates or even inside other widgets.

As an example, the Head, Header, TopNav, and BottomNav widgets.

So widgets are treated as templates, you can treat widgets the same as templates, anything in the templates

you can use inside widgets, including html code, plugins, gadgets, other widgets, etc.

Widgets files are located in the themes views folder. In each theme view folder where the templates are located,

the widgets files reside also.

Types of Widgets - Theme Specific Widgets
================================

Widgets inside the themes view folder are theme specific widgets, each theme can use the widgets

inside its views folder, it can not use widgets from another theme, these widgets are called theme

specific widgets.

Types of Widgets - Shared Widgets
==========================

There is a folder called widgets in the application root folder, this is different from the widgets folder which

exists inside each theme folder. That folder is used for widgets that can be shared among all themes, widgets

inside this folder can be called from inside any theme templates or gadgets.

Creating and Using Widgets

====================

Since widgets are templates (views) blocks, to create a widget, just create it from the admin center

or create an empty html file and name it with the unique name for your widget.

To use your widget inside your theme, upload that widget file to the theme widgets folder.

To use your widget inside any theme, upload that widget file to the main widgets folder.

Calling the widgets inside the templates or other widgets like that:

[widget::widget_name::]

or use the shortcut:


[w::widget_name::]

must start with [widget:: or [w:: and must end with ::] for closing the widget tag.

[widget::Head::]

[widget::Header::]

[widget::WelcomeArea::]

[widget::LogoArea::]

[widget::TopNav::]

you will find a widgets files with these files name in the theme widgets folder.

Widgets names are case sensitive so Header is not the same as header even on windows system they are same.

Widgets Arguments

==============

Even though widgets are static html or template blocks, you can insert place holders for

variables that can be passed to the widgets and replaced like you pass a variables to a function

in any programming language.

For example if you created a widget to display a different titles and messages, say the widget called hello

which contains a simple code like that:

< b >[:title:] < font color="red" size="4" >[:msg:]</ font>< /b>

Note in this widget code we inserted  the tags or placeholders [:title:] and [:msg:], now you can

pass different titles and msgs to this widgets like that:

[widget::hello (title="Good Morrning", msg="Welcome, happy new day")::]

[widget::hello (title="Good Night", msg="Welcome, how was your day, happy dreaming ")::]

As you can use, widgets are reusable, you can use the widgets unlimited times on the same template or another widgets.

You can pass unlmited argument to widgets, make sure to include the argument value inside a double qoutes and

separate among tags by commas (spaces after and before are ignored), so the general call for widgets in this format:

[widget::widget_name (arg1="value1", arg2="value2", arg3="value3", ,,,, arg_n="value_n")::]

arguments values can be of any type, strings, numbers of any type, esacaped html code, etc.

Widgets Priority
============

The template parser searchs the templates for any widgets tags, then searchs the current user theme

widgets folder for that widget file, if found will be loaded and processed, if the parser did not find a widget

file in the theme widgets folder, will go to the shared or global widgets folder to find if a shared widget with

that name exists and will use it if found, if not found will display a widget not found error message in the

widget placeholder to alret the site designer or owner that it can not find a widget file with that name.

Disabling widgets
=============

You can disable widgets tags in your templates by simply including it inside an html comment tag,

the widget parser will ignore any widgets tags preceeded by a comment tag <! --  without displaing any errors.

Widgets folders
============

As explained above, these are theme specific widgets folders and one shared widgets folder.

The application folders looks like this:

...
|-temp
|-theme-|
             |-default-
                          |-images
                          |-views
                          |-widgets   <-- this is the theme specific widgets folder

|-upload

|-widgets   <-- this is the shared or general widgets folder

Boardawy software is a free GPL (General Public License). You can download it from our download page and use it for free provided you keep the powered by message that displays at the bottom of the pages. You can see order a removal license to allow you to remove this message. Boardawy "Powered By" Removal Instructions (Open your admin.cgi center, click on Class Editor, select the class "Footer". You will find this message and you can delete it).

You can order Bordawy Powered By Removal License from our website only:

http://www.mewsoft.com/Order/Order.html

For live demos, latest version, updates and bug fixes, and support, please visit our website http://www.mewsoft.com/

Thank you

Dr. Elsheshtawy Ahmed Amin
Ph.D. Physics
sales@mewsoft.com
www.mewsoft.com

Mewsoft Open Source Products Installation Instructions
 

These installation instructions assumes by now you have the program on your computer either by download from the internet or on a CD-ROM or on your hard drive. The program comes as compressed single zipped .zip file. You can always download the latest version .zip file from our website download page or from My Account if the product is not a free using your license number if your license is still valid and active.

These installation instructions applies also for all Mewsoft open source products (Auctionawy, Classifiedawy, Searchawy and Boardawy).
 

1. Unzip the product file product.zip (for example, boardawy.zip, auctionawy.zip, classifiedawy.zip, searchawy.zip).
2. Configure your FTP program.
3. Edit the first line of all *.cgi files to point to location of Perl on your server if required.
4. Rename *.cgi to *.pl if your server requires the .pl extension for Perl scripts (or to any other extension).
5. Transfer all files and directories with the same directory structure on your computer.
6. Change permissions on all files and directories.
7. Create MySQL (or MS SQL) database from your website control panel.
8. Run the Admin program from your web browser and setup the program configuration.
9. Run the main program from your browser.
10. Register as a user and test the program settings and features.
11. If you have any problems contact go to Mewsoft Support Forums.
12. Important Notes.
13. Congratulations.
     

Place the file "product.zip" in any directory on your computer and then unzip it. The unzipped directory structure is the same structure of the program as it should installed on your server. The file unzip under two main directories as follows:

unzip directory/cgi-bin/forum
unzip directory/html/forums

The directory forum and all its subdirectories and files should be transferred to your server CGI
directory which is normally your cgi-bin directory. On Sites that use cPanel control panel, this directory normally under the main website folder public_html/cgi-bin, so you should transfer the folder cgi-bin/forum to the server folder /your root/public_html/cgi-bin/forum.

 The directory forums and all its subdirectories and files should be transferred to your server non
cgi directory (also called documents directory or html directory or root directory) which is normally your httpdocs or public_html or www directory.

If required only, Open all *.cgi files only with any text editor like notepad prgram and change the first line only in each file to point to Perl
location on your server. Normally it should be one of the following:

On *.nix servers (Linux, BSD, Solaries, Unix, etc):

#!/usr/bin/perl
#!/usr/local/bin/perl

On Windows servers:

#!C:\perl\bin\perl.exe

You can install and run the script testserver.cgi which comes with the software and it will show you all your server configuration.

If you do not know where Perl is located, ask you system administrator or hosting company, or if you have a Telnet on your Unix server, you may run
these commands to find where is Perl located as well as sendmail program only if your are on a unix server:

which perl
whereis perl

also for the mail program location:

which sendmail
whereis sendmail

Remember to insert "#!" in front of the Perl location directory as follows:

#!/usr/user/perl
 

4. Rename *.cgi to *.pl if your server requires the .pl extension for Perl scripts(or to any other extension).

The executable files comes with *.cgi extension only. This is the extension required on most servers for
executable files. If your server still requires Perl programs to use the ".pl" extension or any other extension,
you should rename *.cgi files to *.pl.
 

5. Transfere all files and directories with the same directory structure on your computer.

These instructions assume that you have FTP access to the server and that you have some basic knowledge of how to use an FTP program to go to different directories on your site, create directories when necessary, and to upload files to your server.

If you do not have this basic knowledge, we recommend getting an FTP program such as this free one http://www.filezilla-project.org/  and reading its documentation thoroughly in order to learn how to use such programs.

When uploading all of the text files for the software, be sure to set your FTP program to
transfer in ASCII mode (the graphics files, such as those ending in ".gif" and ".jpg", should be transferred in Binary mode).
The scripts, Templates, ini files, JS files,  Language files and setup files will NOT work properly if you transfer it in binary mode.

If your FTP program allows you to transfer the directory and all its subdirectories  then you can in one step transfer all the /cgi-bin/forum directory and all its subdirectories
and files to your CGI directory which is normally your cgi-bin directory and also in one step transfer /html/forums and all its subdirectories
and files to your html directory which is normally your httpdocs or public_html directory.
 

Setting permissions is the very important for the program to run correctly. Changing files permissions is different from operating system to another.

If you are on a Unix server (Such as Linux, FreeBSD, Solaris, etc), use your FTP program to change files and directories permissions. Most FTP programs allows setting permissions by selecting the files and right clicking the mouse then selecting the option permissions or as your FTP program manual says.

On Unix servers also you may set permissions from your Telnet program, log into your server using "chmod" command.
Here are the required permissions on each directory and file:

on Unix server:

chmod -R 755 /cgi-bin/forum/*
chmod -R 755 /html/forums/*

on Windows server

On Windows servers setting permissions is different than Unix servers and complicated, you have to go to your website control panel on see how you can set files permissions.

/cgi-bin/forum/* should be read /execute
/cgi-bin/forum/data/* should be write/read
/html/forums/* should be write execute

Of course you can set the permissions according to your server security.
Some subdirectories are empty at the installation time, these directories will be used later by the program.

Now before you go further, you need to know if the required Perl modules installed on your server or not.
If not installed, you will need to contact your hosting company or server administrator and ask them to install these Perl modules.

Please do not contact Mewsoft or ask our support for installing Perl modules, Perl modules has to be installed by the hosting company or the server administrator as it needs server root access unless you have your own dedicated server and you have root user login access to that server, then you can hire Mewsoft to install Perl modules or hire anyone else.

These modules are almost required by all Mewsoft products that uses SQL database like Auctionawy, Classifiedawy, Searchawy, and Boardawy:

Required Modules:
DBI
DBD::Mysql
Archive::Zip
Crypt::SSLeay
GD

Optional modules:
Business::OnlinePayment
Finance::Quote
Mail::POP3Cleint
Finance::QuoteHist

To help you determine if these modules installed or not, run the program "testserver.cgi" from your web browser,
this file is available with the software package in the same cgi files directory. You can access this file from the browser as:

http://www.yourdomain.com/cgi-bin/forum/testserver.cgi

Now you have done a great gob. If you have carefully followed all of the instructions above, you are now ready
to start the admin program to complete the program configuration and installation. Please point your browser
to the URL of the "admin.cgi" file as follows:

http://www.yourdomain.com/cgi-bin/forum/admin.cgi

where "www.yourdomain.com" would be replaced by your actual domain name or IP address. Please note that if you renamed
the "admin.cgi" file to "admin.pl" or to any other name, you would need to adjust this URL accordingly.

Only each time you run the admin program you need to login as the system admin, the default login "User ID"
is "admin", and the default password is "admin" if any default but normally you will be able to login without User ID and password.

Please change these login information once you login for your system security.

If the "admin" program runs now, then great gob, the remaining part is very easy. You should see now the admin
program main menu.

From the admin menu click on the  "Configuration" menu option. Change all path's and URL's
to point to your server and all other information. These information are very important to run all the software. You can click on the "Tip" link to help you know your paths and URLs.

The next step is to create a mysql database (of course you must have mysql server installed and running on your
server) and put its information in the admin->Configuration.

Next, create the SQL database tables from the admin->Setup Wizard, click on "Create SQL Tables".

Finally, load the default program settings and the default database, this is very important, to do so, click on "Database & SQL Manager", then click on the link "Restore SQL Database From The Text Files Backup".

The last step is from the admin menu also to set the default language for the program to start properly.
To do so, click on "Language Manager" from the admin main menu, then click on "Prepare All Available Languages
" and also set the default language to "English" by selecting the "English" language.

Now if everything done as it should be you have finished the installation.

If you finished all the previous installation steps correctly, you will be able to run the main  program from
your browser. To to so, please point your browser to the main program on your server as follows:

http://www.yourdomain.com/cgi-bin/forum/forum.cgi

where "www.yourdomain.com" would be replaced by your actual domain name. Please note that if you renamed
the "forum.cgi" file to "forum.pl" or to any other name, you would need to adjust this URL accordingly.

If the program run and you see the main page, then congratulations, and thanks for this great gob.

Now the program is running, but to make sure that all the installation process completed correctly, you need to test
all the program functions. To do so, please register as a user and test every single function as it requires the user
to do. For example, edit your registration information, check the emails sent out.

This will help you detect any problems with the program installation, for example, files not transferred in the correct
mode, permissions not set, directories not created, missing Perl module.
 

In case you were unable to complete the installation process successfully, please go to our site and search the user forum and post your questions and you will get immediate answers and help. of course you can order our installation service and avoid any headache.
 

Congratulations for using our  software products and thank you for your business with us. Please check our sites for more products and offers.

Best regards,
Dr. Elsheshtawy, Ahmed  Aamin
Ph.D. Physics
Mewsoft President
Mewsoft Corporation
sales@mewsoft.com
http://www.mewsoft.com

ExtensionsMgr.pm
Configuration.pm
Admin.pm
data/StartUp.pm

Then upload the module files AutoRss.cgi and RssMaker.pm  in ascii mode to the same directory with the other cgi files.

Change permissions for the file AutoRss.cgi to executable 755 on Unix systems and make it executable by all  on windows systems.

Please note, there is a separate module for each product and no one will work on the other.

If all goes well, start your admin center, click on the link Extensions Manager in your main menu, the link  RSS Auto Generator Manager will be activated, set the various settings and setup cron times and password to start the automation process.

Enjoy!

Thank you

  To install the Dmoz module, simply upload the file dmoz.pm in ASCII mode using your FTP program to your cgi-bin/dir directory or where you installed your product cgi files directory with the rest of the other product cgi files.

After installation, go to your admin center, under "Web Spiders" you will find the link Dmoz Spider.

Demo the Dmoz Crawler here:

http://www.mewsoft.com/cgi-bin/dir/admin.cgi?action=DmozCrawler

1)-To install the Freeder module, simply upload the file Feeder.pm in ASCII mode using your FTP program to your cgi-bin/auction or cgi-bin/classified directory or where you installed your product cgi files directory with the rest of the other product cgi files.

2)-Go to your admin center, click on Setup Wizard, then click the link Create SQL Tables, this process will add three new SQL tables:

AuctionAffiliateAccounts, AuctionAffiliate, AuctionAffiliateStats for Auctionawy

ClassifiedAffiliateAccounts,ClassifiedAffiliate, ClassifiedAffiliateStats for Classifiedawy

Ignore any error messags about other tables that already created or exists.

After installation, go to your admin center, under "Extensions Manager" you will find the links to all the Feeders supported enabled.

http://www.mewsoft.com/help/classified/

http://www.mewsoft.com/help/search/

]]>