howto V4

to change css layout of search box:

go to 'project template' tab --> 'template editor' --> 'css' and append this as new line (you can change it with css controls to fit your needs)

#search_box{background: #a6a6a6;border: 1px solid #9b9b9b; color: #ffffff;height:22px; padding: 0 7px;border-radius: 2px;margin:8px 32px 8px 8px;}

to customize search button: 

#search_button{background: #1b1b1b;border: 1px solid #545454;color: #ffffff;position: absolute;right: 7px;top: 8px;width: 24px;height: 24px;border-radius: 2px;}

search area (div) can be also customized :

#search{background:#d8d8d8;border:1px solid #cacaca;border-radius: 10px;}

you can also use images as background...

to make search button invisible:

#search_button{display:none;}

to remove label from search button (in case you use background image), go to language setting tab --> interface labels --> search labels and change label for 'search'

By default ezg shop page  is open, everyone can use it without registering.

If you want to get users to register (log-in) on checkout follow this steps:

To set up a Catalog/Shop page in EZGenerator 4, first of all you need MySQL to do this. Get credentials from your provider (or set up MySQL database in your server, if server is yours). EZGenerator cannot create the database automatically. The database is one of the parameters required in the MySQL settings inside EZGenerator, so make sure you have this set up before you activate the MySQL in your project.

To make a shop page:

1. Go to EZGenerator program and open Project Settings -> MYSQL Settings;
2. Fill the information required. Ask your provider or check your server settings for the credentials;
   
   • In most cases (when the site and the MySQL server are on the same working station, the host is "localhost";
   • Note: It's recommended to add project prefix for every project you have. This prefix should be unique (different for every project)!;
3. Check the "Use MySQL for all live pages" checkbox. You won't be able to do this until all the other fields are filled;
4. Now you have the Shop/Catalog pages non-grayed (and also included in the page types list) when you try to add one of them.
5. Add the desired page and make all the layout changes you want (using the macros and custom code on the template pages);
6. Add payment process partner (if needed). It's explained in this howto section (one of the other threads);
7. Publish the site;
8. In Online Administration go to your Shop/Catalog back office and manage the page. All the changes (adding/editing products, part of the Shop/Catalog pages settings, orders, categories) are managed via the Online Administration;

Note: What you cannot find in the Settings module of the Shop/Catalog inside Online Administration, you can find inside EZGenerator. When your Shop/Catalog is selected in the project tree, click on the Shop/Catalog Settings tab or the Page Settings tab to change the current settings.

To use add custom fields to the shop products data, follow these steps:

1. Open the shop page settings
2. Open the Data dialog
3. Edit the fields
4. Confirm the changes
   
   

   
   
   

5. Open the page where the changes should be visible.

6. Open the macros fields dialog

7. Select the new fields from the macros list

8. Place the macros to the desired place
   
   
   

9. Upload your project changes

10. Go to the shop Online Administration

11. Go to the "settings" section

12. Click on "Update database" button

13. Modify the products (or add new ones)

Note: User input field does not have corresponding field in the products management section (as this is something users fill, not the shop moderator).

To add custom page content, that's not compatible with the current EZG structure (no possible to add the content directly into the pages), try to use this:

1. Set up the extra page you want with the content you want added into it.
   If you want to manage the page via EZG (and make it part of the project anyway), you can try this:
   
   • make new page in EZG (wherever you prefer).
   • in page settings check the hide template checkbox (to be able to check it, you have to check hidden in menu first).
   • add macro NOPAGEFOOTER on the page
   • suppress float login (if active)
   • add the required content (you may also use the HTML button in Editing tools for it).

   If you want to make your own page - use external FTP (or some of the ignored from optimization folders in EZG) and upload the desired file on the server. For this option you will have to make full html structure (html, head, body, ect tags), because of the iFrame and no EZG template included to build the page structure.

2. Once you have the page prepared, make the other page (or open already existing one) that will hold the extra page.
3. Use the Inline frame option from Widgets and for source add the url of the page, created in 1. (you can use relative paths too in this field).
4. Set up the rest of the fields (ensure you have unique element id and appropriate name) and settings (the settings button) in the Inline frame dialog.
5. Confirm and upload

To change the upload size of your files (if the limit you have is too small), you can try one of these methods:

(The default size is most probably 2MB, in all examples we're going to change it to 5MB)

1. Using the file php.ini
   Keep in mind, that this is the recommended option, but some hosts don't give you access to do this.
   Open the file, find and change the values of these two lines:
   
   • upload_max_filesize = 5M
   • post_max_size = 5M



   The lines may be commented with semi-column (;) and you will have to remove the comment.
   
   

2. Using the .htaccess file.
   Add the following lines in the .htaccess file in your EZG root directory (online):
   
   • php_value upload_max_filesize 5M
   • php_value post_max_size 5M

   
   If there is no such file, you will have to create one (just make file with this name and add the code inside).
   
   
   

3. (If none of the above works) Contact your administrator to change the size for you.
   
   
   

Note: The value of the size is one char only everywhere. It's 10M, not 10Mb or 10MB!

Note 2: The php.ini changes may require server (actually apache service) restart. Try to restart it somehow (or contact administrators for this) if after the change it still doesn't work.

Note 3: Additional changes you may wanna do together with the upload size, is the upload time. It could be changed by these two parameters:

[php_value] max_execution_time 200
[php_value] max_input_time 200

(The [php_value] part is for the .htaccess file only! And is used without the brackets)

Order Pending Reason parameters :

multi-currency:

You do not have a balance in the currency sent, and you do not have your Payment Receiving Preferences set to automatically convert and accept this payment. You must manually accept or deny this payment.

order:

You set the payment action to Order and have not yet captured funds.

paymentreview:

The payment is pending while it is being reviewed by PayPal for risk.

unilateral:

The payment is pending because it was made to an email address that is not yet registered or confirmed.

upgrade:

The payment is pending because it was made via credit card and you must upgrade your account to Business or Premier status in order to receive the funds.upgrade can also mean that you have reached the monthly limit for transactions on your account.

verify:

The payment is pending because you are not yet verified. You must verify your account before you can accept this payment.

other:

The payment is pending for a reason other than those listed above. For more information, contact PayPal Customer Service.

source

New sidebar macro : % BLOG_RELATED%  is available since version 4.0.0.119..

A little explanation how this macros works:

Relation between posts is defined with post keywords (you can add comma separated keywords for each post in blog)

This macro collect all keywords defined for all posts currently displayed on page and search database for all other (not displayed) posts with same keywords = related posts

Inside ezgenerator you can select position of submenu's on page (left, right, top, bottom and inside menu's)

first 4 option will place submenu's as left/right/top/bottom panel inside page area for example :

if you need to place menus on custom position within page, you can use %SUBMENUS% macro, as here:

with this result :

to test if sessions are properly configured on your site:

1. download the sessions_test.zip

2. Unzip and manually upload (using external ftp program) or upload via EZG (using the extdocs folder, e.g. put them into it and publish)

3. Open the file session_test.php and click the link

After clicking the link you should see on another page the variables from the previous one. If they're blank, then there is something wrong with the server (probably the session_save_path is wrong).

Following parameters can be used in all Blog/Podcast sidebar macros

(  BLOG_ARCHIVE(), BLOG_MOST_VISITED()  BLOG_TOP_RANK()  BLOG_FULLLIST()  )

% date%  % DATE[date parameters]% % free_field%  % excerpt% % title% % category% % image% % image[width,height]%  % item_url%
in podcast also %subtitle% %author% are supported

in BLOG_FULLLIST() there is also additional macro:  % content%

to link slide from other page:

1. Check slide-bar id, you can see id in slide-bar properties dialog

2. Go to the page where you want to create the link.

3. Insert link to the page containing the slide-bar, and append ?id=X to the url. X = slide number (slide numbers start from 1) and id is slide-bar id

Example: ../documents/slidebar_page.html?sl21=2.

We have a blank templates available called 'zero'.
 

If you want to design your own template, you have few options:

• Use Zero/v1 template (which is in fact empty template) and define layout for each page.

• Use Zero/v**980 templates, where you define the layout for each page and use EZG menu's. To insert menu, right-click in page and use ZERO mode fields option.

• Customize one of the existing templates, using Template Styles/Html option.

In most templates, you can use editable images.
Change the templates editable image with your companies logo.

• Rightclick in the editor on the template image.
• Click the editable image properties.
• Locate your logo image on your hard disc.
• Add your logo to the template.

The EZGenerator template images can be customized.

Most of our templates have at least 1 image that can be changed at wish.
Please add a picture that reflects your business best.

You can also create a custom template starting from the Zero template.

Your EZGenerator license comes with a 1-year update subscription.

You have full access to all templates and program updates during 1 year.
After the period of free updates, if you want to get further updates you should subscribe for a new 1-year update subscription

It is NOT REQUIRED to get 1-year update subscription, you can use EZGenerator without subscription if you don't need updates.

You can pay for subscription later when you need updates again (which will give you rights for updates for next 1 year).

When your update subscription gets expired, this doesn't mean EZGenerator is expired or unusable, you can keep using software and already downloaded templates.

No it isn't possible to download all templates at once.

There is no need to download all templates.
You only have to download the templates you actually use.

If all our customers would download the complete 1 Giga byte batch of templates at once, our download server will turn unusable.

It is only possible to download one template at a time,
however you can download all 10 or more styles of that one template at once.
 

Choose a template style before you start downloading.
Please check the web templates gallery page to see previews of all our templates.

Click the preview window to get a full screen popup of an example website rendered in the chosen template and style.

The easiest way to create this effect is to:

Make different projects for each website.
Each project can have an other template.

In the index page of one project, change the link EZGenerator adds by default into a hand made link to the path of the different websites.

No. Both the EZGenerator program as the EZGenerator templates are only available online.

The EZGenerator installer is a 90Mb download.
A default range of templates is included in this installer.

Extra templates can be downloaded at the time you need them.
Templates are updated and added regularly.

EZGenerator works with its own templates only.

We provide a wide range of templates ready to use.

Easy customize:

EZGenerator templates have easy customization options.
No special knowledge is needed for these changes.

EZGenerator allows you to easy customize these template options:
- template image (the photo on top of the template)
- background
- colors
- fonts (style/color/size)
- buttons
- menu / category / page header items
- ...

More options for advanced users:

Radical changes in templates are possible, but it is a specialized and technical process.

EZGenerator includes a template editor, which allows you to highly customize a template.
This can be done starting from the empty 'zero' template, or from any other existing EZGenerator template.

You need to be an advanced user with thorough html/css/php knowledge to make these changes. 

EZGenerator supports import of Artisteer generated templates.

This is NOT an error.
This is an EZGenerator demo version limitation.

Once you buy the full registered EZGenerator program all letters will stay as they were entered into the program.
 

• The Trial version will switch the letter 'a' to the letter 'e'
  on every webpage you render.
• Trial version will add a footer on every webpage saying:
  'This page has been generated with the Trial version of EZGenerator'.
• All processed Images will get a 'Trial' Watermark.
  
  

For all demo limitations see the page on this link:
EZGenerator trial limitations

No, but we do have very detailed online information available:

• The detailed EZGenerator help file.
  F1 in the program or available online on the EZGenerator web site.
  This help is printable, but it will be difficult to find something in its printed version.
  
  
• This EZGenerator how to blog
  for often asked questions on how to use specific EZGenerator features.
  
  
• The EZGenerator user forum
  If none of the above sources give you an answer.
  Our technicians will answer your questions posted on the forum.
  
  

Your project is saved in [EZGenerator]\\data\\[Project]
where [EZGenerator] is the folder EZGenerator is installed on your PC
and [Project] is your project name.


This folder contains all your project content.

This folder however does not contain the data that is inserted online, as is the case with the special PHP pages as Blog, Calendar, Photoblog, Guestbook, Online Editable page, Podcast, Subscribe - this data is stored on server.

The EZGenerator system requirements need you to have Internet Explorer v7.0 (or a higher version) installed on your pc.

EZGenerator uses an integrated Internet Explorer browser.

You can install Firefox (or any other browser), but you should not uninstall Internet Explorer from your pc.

Yes, you can without a problem sell websites you make in EZGenerator to your customers.

You can not give a copy of the EZGenerator software installation to your customer, in that case you need to order an additional EZGenerator license on your customers name.

EZGenerator is a directly downloadable product.
You can download the installer (± 90 Mb in size) directly from our servers.

After your purchase payment is completed, you are directed to a page with download, installation and registration instructions. You get access to the EZGenerator links on your private download page: 'MY ACCOUNT'. If you follow these instructions, you will be up and running in no time.

This means that we do NOT send you a CD-ROM afterwards.

The advantage of this method is that we can easily provide you with :

* No shipping costs
* Direct online delivery
* FREE upgrades
* Pre-releases
* Manuals
* Tutorials
* Tech Support on our forum
* etc...

Order processing for EZGenerator is instant as soon as your payment is received.
Depending on the payment processing company your order uses, a few minutes delay could occur (maximum 30 minutes).
 
RBS Worldpay / PayPal
As soon as your payment is processed, the software is available on your personal 'my account' page. Most payments are processed instantly.

Avangate
A delay of maximum 15 to 30 minutes is possible.
Please do not retry an order directly.
Avangate will try to verify your payment manually if automatic processing is not possible.

Order status:
One of these statuses is shown after the payment page:

unpaid -> you can restart a new order payment after 30 minutes.
pending -> contact Avangate to give them extra information about your orders payment.
on-hold -> contact Avangate to give them extra information about your orders payment.

Contact Avangate:
Avangate has a 24/7 hotline, where you can call for human help if your orders payment is for some reason not accepted.

Please check for e-mail messages from Avangate before calling them.
There will be a specific ordering number in their e-mail message.
Communicate that number to the Avangate staff member, so they find back your order try faster.

Shopper support on order and payment related issues:
International: +31 88 000 0008 (24 hour support)
USA and Canada: (650) 963 - 5701

The EZGenerator program interface and all support documents are available in English ONLY.

EZGenerator web projects and web sites can be in any language you like.
Web sites with multiple languages are possible.

Localization of all text messages used in the web site is possible.
Some languages are supported by default in web site projects.

The EZGenerator web project isn't the same as your online web site.
The web project contains more information than the online pages.

EZGenerator includes multiple backup options.
Please first check if one of these options backup files are still available to recover your web project.

EZGenerator can not download your online web site and turn it back into an EZGenerator web project.

It is possible to simply copy the EZGenerator web site project directory from one computer to another.

How to transfer project in between v4:

• Make sure your project and EZGenerator 4 are using the latest available versions of program and template. If a newer version of the program or template are available, download and apply them before moving the project! 
• Copy your project from Program Files/ezgenerator4/data/ folder and paste it into Program Files/ezgenerator4/data/ folder on the other computer.
• Open your project directly on the other computer

How to transfer v3 project to v4:

• Make sure your project is using the latest available version of the template. Still in V3, search for template updates and if a newer version of the template is available, download and apply it to your project before moving the project to V4! 
• Copy your project from the Program Files/ezgenerator3/data/ folder and paste it into the Program Files/ezgenerator4/data/ folder.
• Open your project in EZG 4.
• Do a Full Build.
  
  

Yes, it is safe, as long as you are not deleting the project EZGenerator is currently working with.
EZGenerator needs this project or it might malfunction at startup.

EZGenerator online updates are downloaded automatically at startup of your EZGenerator program.
The downloaded update is only executed as soon as you close and restart the EZGenerator program.

The online update will automatically change your EZGenerator program to the latest version, regardless of your current EZGenerator programs version number. The online update detects all outdated EZGenerator files and replaces them with the latest EZGenerator program version files.

Your webproject directories are never touched by the online update.

If you are an existing customer the following applies to updating EZGenerator and on-line template access.

PROGRAM UPDATES

EZGenerator 2 to 4 - You can update from 2 to 4 for FREE. First update from 2 to 3, then to 4.

EZGenerator 3 to EZGenerator 4 - You can update from 3 to 4 for FREE.

Once updated you will have access to further free updates ONLY if you have purchased EZGenerator 3 or 4 within the last 12 months. You will then have access to your remaining balance of free updates and template access to 1 year from the date of purchase. To purchase 1-year updates, log into your MY ACCOUNT and click here.

1-YEAR ACCESS TO UPDATES & TEMPLATES

You have access to 1 year of free program updates and on-line template download for 12 months after purchase of EZGenerator OR renewal of updates.

If your 1-year updates/template access expires, EZGenerator 4 will continue to function as follows:

YOU CAN still make websites and create your own templates AND use templates already downloaded.

YOU CAN renew your 1-year access at any time and get another year of program updates & templates.

YOU CAN'T download new templates and won't receive program updates.

Image-Line

To Use Ogone as payment provide in shop: 

a. add new page and select layout "shop_ogone"

b. create Ogone account (on Ogone website)

c. Configure following options in Ogone account

in 1. use url of your shop page with ?action=checkout at the end

in 2. SHA-IN : define password phrase here, you will also need it inside ezgenerator payment settings (see below)

in 3. use url of your shop page with ?action=return at the end

enable option 3. and 4.

in 6. SHA-OUT : define password phrase here, you will also need it inside ezgenerator payment settings (see below)

c.) inside EZGenerator, shop page settings, payment tab define following parameters

ID : your Ogone account ID

SHA-IN,SHA-OUT:  password phrases you defined inside Ogone

No, there is no default procedure for downloading EZGenerator updates manually.

We develop and update EZGenerator at an almost daily basis.
Each time you start EZGenerator, the program will download the most recent program version automatically.

We suggest you try to use the automatic update from Menu help > Online update.

If the automatic update does not work, please check our EZGenerator support forum.

You will find suggestions to solve most common update errors there.

Yes, you can unlock the EZGenerator 4 demo program.

Try out our EZGenerator 4 software by installing the demo program.
Start creating your web site.

When you bought an EZGenerator license, you have the program available in your 'my account' page on www.image-line.com

To unlock the demo program to the full version, enter your 'my account' sign in e-mail address and password into the EZGenerator about window. For details, check this step by step procedure. 

Web site projects you started in the EZGenerator 4 demo stay available in the registered full software.

Yes, this is possible to install, register and use EZGenerator on an offline computer.


If you don't have an internet connection please use this procedure to download and register EZGenerator :

1. Sign in to your 'my account' page on any internet connected computer.
2. Download the EZGenerator installer file and the flregkey.reg unlocking key file from the link you received on your 'my account' page.
3. Write the EZGenerator installer file on a CD-ROM/memory stick and install the program on the offline pc.
4. EZGenerator 4: Run the downloaded key file to unlock your EZGenerator 4 program.


For the web templates:

1. Install and register EZGenerator on an internet connected computer.
2. Fully download the templates and styles you like to use.
3. Write the ...EZGeneratorwebtemplates directory to a CD-ROM/memory stick
4. On your offline computer, overwrite the installed ...EZGeneratorwebtemplates with the CD-ROM/memory stick saved files.

ATTENTION: EZGenerator 4 no longer uses a 20 digit serial number for registration.

New procedure:

A. Install the EZGenerator 4 trial program.
B. Enter your 'my account' sign in details into the EZGenerator 4 program (in the about window).

B. Step by step registration of the program:

1. Start the EZGenerator trial program.
   
   
2. Click the EZGenerator logo at the top right of the program (arrow 1) and select 'About EZGenerator' from the menu (arrow 2)
   
    
    
3. Click the 'Unlock' button
   
   
    
4. Enter your www.image-line.com 'my account' sign in details.
   This is your e-mail address used when ordering EZGenerator and your own chosen password.
   
   !! Attention: Do not forget to read and accept our 'Terms of use'
   
   Click the 'unlock' button to continue
   
   
    
5.  Your EZGenerator program is now registered / unlocked.
   
   
   
   
6. You see your name and customer number appear in the EZGenerator About window. 
   
    

EZGenerator checks your IP address upon registration.

Internet Service Providors with dynamic IP addressing do not pose a problem for you to register (or re-register) your EZGenerator software.

You can use EZGenerator yourself multiple times without any problem, as long as you only use the programs one at a time. Just make sure nobody else uses your registration code (we check users/IP).

When we see that your registration is used on a lot of computers, simultaniously, geographically spread, we will start asking questions. But when you use it on your own computers, this won't be any problem at all.

Your EZGenerator registration and installation stay available to you at all times.
Find them on your 'my account' page under 'my licenses' (sign in might be needed)

Your \\'my account\\' sign in codes are:
Re-download the registration file from your 'my account' page after sign in to www.image-line.com
- Sign in e-mail: The e-mail address you used to order EZGenerator
- Password: The password you entered/chose yourself when ordering.

Click the image below to see a video of the complete process:


When you forgot your password:
Go to the password recovery page: Forgot your password? Retrieve your password here!

When you forgot your sign in e-mail and/or password:
Contact our registration staff by creating a private 'support ticket'
Add your original ordering information to the message (name, postal address, e-mail, payment ID, ...)


EZGenerator 3 users:
Your old EZGenerator 3 serial number is also listed on the 'my account' page under \\'my licenses\\'
Find it at the bottom of the EZGenerator registration information box

use this to add text links for all shop categories in any page or editable area (even for pages in different project)

use insert html and following code :

for vertical list:

< script type="text/javascript" src="../shop/shop.php?category_vlist">< /script>

for horizontal list:

< script type="text/javascript" src="../shop/shop.php?category_hlist">< /script>

style of links can be tweaked by adding extra css to page :

for example

.ver_cat_list a{font:11px verdana;color: #c0c0c0;}

or

.hor_cat_list a{font:11px verdana;color: #c0c0c0;}

All Rss Feeds (including EZG feeds) are displayed in Google Chrome as code...

(Google Chrome is only browser without build-in Rss Feed parser)

you can solve this by installing Rss Feed Parser Plugin in Google Chrome:

https://chrome.google.com/webstore/detail/nlbjncdgjeocebhnmkbbbdekmmmcbfjd

How to install the flash tags cloud:

• Download WP Cumulus flash plugin at WP CUMULUS Flash tags cloud
• Unzip the archive and manually upload file tagcloud.swf in folder extdocs/ on server.
• Open your project in EZGenerator, go to the Blog/Podcast page and insert
  macro from Fields panel.

If you want to change the tags cloud size or colors, here is the list of parameters you can use:

%FLASH_TAGS_CLOUD(width,height,tag color,tcag olor2,hover color,background color,transparency,tspeed,distr)%

• Width - width of tag cloud.
• Height - height of tag cloud.
• Tag color - tag color.
• Tag color - tag color for less important tags. If supplied, tags will get a color from a gradient between both colors based on their popularity.
• Hover color - tag mouseover/hover color.
• Transparency - is set to true will set background transparency for the tags cloud. Possible values: true/false.
  Tspeed - determines the speed of the sphere’s rotation in percentage. The default is 100, higher numbers increase the speed.
• Distr - even tag distributiosn along sphere. If set to true, the tags are distributed evenly over the sphere’s surface. Possible values: true/false.

Example: %FLASH_TAGS_CLOUD(300,200,e520ae,91cee3,ffcc00,ffffff,true,100,true)%

To use the plugin for other languages (that has special non ASCII characters), you’ll need to get version of tagcloud.swf that supports this.

For some languages such version is already available (Russian, Hebrew, Turkich, Polish) here, for others you can prepare such version by yourself following the instructions at:

How to add more characters to the Flash tags cloud

When you have proper version of tagcloud.swf, simply upload it on server in extdocs/ folder to replace the default one.

System requirements:

• Windows XP/ Vista / Windows 7
• Internet Explorer 7 (or higher version)
• Screen resolution: 1024 x 768 pixels or higher, at 16 bit color mode (65536 colors) or higher
• Internet connection
• Latest Flash installed in Internet Explorer

Server Requirements:

EZGenerator created sites will work on any web server.

• PHP Requirements - you need minimum PHP 4.3 installed on server, if you use any of the PHP pages and features (as Blog, Podcast, Photoblog, Calendar, Newsletter, Guestbook, Tell a friend, Request, Shop, Search, Counter, RSS Parser and Online Administration panel ).

• MySQL Requirements - you also need minimum MySQL 4.1, if you have switched project to MySQL and use any of the PHP driven pages and features.

How to install EZG v4:

• Go to http://support.image-line.com/member/profile.php and login
• Click on EZGenerator link under My Licenses section
  

If you have problems with your account and can't find My Licenses section, visit our Ticketing system and post request at: http://support.image-line.com/ticketing/issue.php

• Go to EZGenerator 4.x procedure section and download EZG 4 installer

• Download the registry file by clicking on regcode link (.reg)
• Install EZG 4. You don't need to uninstall EZG 3. Install EZG 4 in different folder in Program Files.
• Run the registry code file that you have already downloaded

How to transfer v3 project to v4:

• Make sure your project is using latest available version of template, still in V3, search for template updates and if newer version of template is available, download and apply it to project before moving project to V4! 
• Copy your project from Program Files/ezgenerator3/data/ folder and paste it into Program Files/ezgenerator4/data/ folder
• Open your project in EZG 4
• Do Full Build

Possible problems with v4:

• Catalog and Contacts modules are removed. You don't have local database anymore. All pages that read data from this local database will not work in EZG v4 (as non-php Catalog/Contacts lister). You will have to replace them with the new MySQL pages (catalog and shop).
• In EZG v3 standard shop/catalog pages use Catalog module to store data. You can have multiple shop pages using same database from catalog module. In EZG v4 shop/catalog pages use MySQL only and each shop/catalog page has its own database table.

Important: If you use standard shop (non-mysql) along with Catalog module and you want to keep them,  DON'T move to EZG v4.

If you have standard shop/catalog (non-mysql) and want to move to MySQL shop/catalog, you have to add new shop/catalog page and make one time data conversion. Don't panic, you will not loose your existing shop data. After you add new shop page and upload on server, you have to go to Shop online admin panel. There is option Import, where you will be lead step by step into the date conversion process.

• You may encounter problems with old page layouts. If this is the case, re-load the layout - right-click inside page and select Page Layout Presets, then Load Page Layout Preset and select certain layout.
• For all form pages (as Newsletter and Request) make sure to open email field properties (by double-clicking on the email field in EZG) and check Validate as email.
• You have to use only v4 compatible templates. You can check if your template is v4 compatible at http://www.ezgenerator.com/documents/webtemplates.html (simply check if it is in the list). Also make sure you are using latest version of template. If you are using template that is not in this list, you better continue using EZG v3 for this project.

MySQL support:

EZG V4 can use MySQL for all php features (Blog, Calendar, Counter, Search, etc).

You set your project to either use MySQL, or flat files. You can't have MySQL blog and flat file calendar in same project.

Only shop/catalog page always use MySQL. There is no flat file catalog/shop.

To switch your existing project to MySQL, you have to go to Project Settings >> MySQL Settings an check Use MySQL for all Live pages and do Full build.

Important: If you switch your existing project to MySQL, all php features (Blog, Calendar, Counter, Search, etc) will be automatically transferred to MySQL, which means data will be moved from flat file to MySQL. So, you will not loose existing data!

What if I use separate database for each MySQL shop page?

In v4 all pages use same database, but each has its own database table.

1) you need to use phpmyadmin panel (this is administrator MySQL panel)
2) you have to choose one database that you will use for your project
3) you have to export all other databases (that you use for shop pages) and then import the tables in the central database that you will use

On some pc's registry settings for Javascript on local page becomes corrupted.

If Javascript for local pages is disabled, some EzGenerator features doesn't work anymore:

If you experience problems with one of the following :

- New Project Dialog

- Edit mode displays very small editor and you are unable to edit pages

- in V4, templates dialog, you are not able to select template variations

check following registry keys in registry editor:

HKEY_CURRENT_USERSoftwareMicrosoftWindowsCurrentVersionInternet SettingsZones

and

HKEY_LOCAL_MACHINESoftwareMicrosoftWindowsCurrentVersionInternet SettingsZones

(to open registry editor, click on windows start button and type : regedit  in search box)

normally , you should only see keys 0 1 2 3 4  there (see image), if you see extra entry, delete it, close regedit, and restart ezg and IE (if open)

to add Tell A Friend As Popup on homepage (or any other page):

1. Add new blank page in your website, on page settings panel, visibility section, enable : Hide In Menu and Hide template options

if you use floating login, you may also want to disable floating login on this page : you can do this in page protection (page settings panel)

2. Add tell a friend widget (widgets --> forms --> tell friend) on this blank page, in Tell A Friend widget settings, enable option Refferer

3. go to your home page (or any other page), add button (or hyperlink), open button properties, select Link Type : internal page and navigate to page created in 1.)

select target : new window, popup or multibox

to link tab from other page:

1. check tabbed table id, you can see id in tabbed table properties dialog, if id is not defined id is : 'tab'

2.Go to the page where you want to create the link.

3.Insert link to the page, containing the tabbed table, and append ?tab=X to the url. X = tab number (tabs numbers start from 1)

Example: ../documents/tabbed_table_page.html?tab=2.

to change tab from link on same page as tabbed table:

1. check tabbed table id, you can see id in tabbed table properties dialog, if id is not defined id is : 'tab'

2. add hyperlink,

---> select link type : javascript:void

---> in url events, select onclick event and define following event:

tab_tab[0].slideTo(2);

replace tab with id of your tab, and specify tab number (2) in above example

When you add posts in Blog or products in the Shop, you add images in the online editor.

In some cases you may need to apply multibox effect to these images.

Here are the steps to achieve this:

A.) if you are using Innova Editor:

1. Insert an image
2. Select the image (added on step 1) in the editor
3. Click on Styles button to open style sidebar
4. Apply style: multibox
5. Set the image as hyperlink and link it to some other image (image you want to display with multibox effect)
   

B.) if you are using Tiny_mce Editor:

1. Insert an image
2. In image properties dialog, select "appearance" tab and select class "multibox"
3. Set the image as hyperlink and link it to some other image (image you want to display with multibox effect)

This is applicable to Blog, Podcast, Shop, catalog and Online Editable page (not to normal pages with editable macros)

If you use google maps inside Tabbed table in any other tab than the first one, google maps is not displayed properly.

To make this work, you will have to set one setting manually as workaround:
- go to Tab Settings in EZG
- there is Parameters box
- set gmid:x (where x is the number of the tab where you have put the google map)

1) make sure your server is linux (as this will only work on linux server)

2) go to blog admin panel online--> settings --> check Permalink Month and Title

3)  when you check this option some text will show below (this is just example, in your case it will be something different):


< IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /galina/v4_m/
RewriteRule ^index.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /galina/v4_m/index.php [L]
< /IfModule>


4) copy this content in empty file with filename .htaccess

5) upload the file on server in the folder where your blog page is stored

Each editable image is built by 2 or 3 files - banner.jpg (the actual banner image), banner.map (opacity mask file) and banner.src (which is renamed banner.jpg and contains background without image). If banner.src is not present main banner.jpg is used as background. The mask file is grayscale .gif, which means grayscale from 0 to 255. Black (0) means full opacity, white (255) stays for no opacity.

All 3 files have same width and height.

You will need to edit banner.jpg in order to change the editable image size:

• Go to c:Program FilesEZGeneratorData[project]templateimages folder
• Edit file banner.jpg
• In case the editable image contains sitename, you will also have to edit two parameters inside site.ini file in c:Program Files/EZGenerator/webtemplates/__shared folder. Open the file, find section [COMPANYTITLEIMAGE] and edit IMAGEWIDTH and IMAGEHEIGHT parameters, which define postion of text upon the image.

We use banner.jpg name here, but it is just an example name. You can have cti_0.jpg, cti_1.jpg or other name.

For some templates you have to also edit few styles in Template Editor, CSS tab - #topbanner, #banner and #search.

to redirect page (after few seconds) to different page, you can use html redirect (you can add this code in page settings --> advanced --> page scripts)

< meta HTTP-EQUIV="REFRESH" content="0; url=http://www.yourdomain.com/index.html">

The above HTML redirect code will redirect your visitors to another web page instantly. The content="0; may be changed to the number of seconds you want the browser to wait before redirecting.

EzGenerator support Google Web Fonts

Google Web fonts works in most browsers, but they are not correctly displayed inside EzGenerator  (edit and browse mode) if Internet Explorer version 9 (IE9) is installed.

to fix this problem, either :

1. enable IE8 browser mode in application options dialog, (drawback is that this will also make new CSS3 features invisible inside ezgenerator)

or

2. download fonts you are planning to use from Google Web Fonts and install them and install them on your pc.

(in this case, both google fonts and CSS3 features will be displayed inside Ezgenerator)

(notice, all above only affects visibility of this features inside EzGenerator, both CSS3 and Google fonts works fine online)

by using jquery/ajax you can put output of any file from your website inside container :

to do this add following code (through insert html)

< div id="output">
< script>
$.ajax({url: "documents/myphp.php", success: function(data){$("#output").html(data);}});

above code will call documents/myphp.php page (can also be html page) and display result inside div with id "output" : < div id="output">

EzGenerator doesn't make backup of online database.

To create backup, use online tools available in control panel of your hosting.

PhpMyAdmin utility is available on most of then hostings.

To make backup of online database in PhpMyadmin :

1. login to your phpmyadmin account

2. select database used in your project and click on export:

3. in export screen left all settings untouched, scroll down and in save as file" select zip option, then click on GO button:

save file, this file is your database backup

notice, on many accounts, database backup is done automatically by host, check your server documentation.

If you like given template, but don't like the square borders - don't worry! You can fix this.

First of all - it depends on the template you're using. Most of them are using images for this.

If there are no images for the borders, do following:

 1. Open Template Editor

 2. Open CSS tab.

 3. Find and change the two properties: box-radius and box-shadow

For more info, check
http://www.css3.info/preview/rounded-border/
and
http://www.the-art-of-web.com/css/border-radius/

Note: These two CSS properties are not new, but they are only supported by IE9 and up (and of course by all other browsers).
Most of the templates are made before IE9 was available, so they were made with images, not with background colors.
That's why in many templates You will have to first replace images with colors to make this work and, of course, it will never work for IE8, IE7 IE6 users. They will see square borders instead.

(Works for all templates)

 1. Open Templates from the side menu.
 2. Open the CSS tab (first one).

 3. Mark (click on) the tab $xm1
 4. Find the Opacity field and enter there the percent of opacity you want to use.
 5. Confirm.

Note: This transparent trick will also make page content transparent!

search query string parameters (required)

q     basic query (search for exact word)

qw   all words (search for all words)

qx   exact words(same as q, but used on advanced search form)

qa   any words (search for any of the words)

search type parameter (t) (optional)

t=a  search whole website (same if t is not specified)

t=m search in all pages in single template menu (menu category)

       when t=m is used, m=menuname  parameter is required (notice: m parameter is case sensitive)

t=p  search in single page

       for special pages with category support (blog/podcast/photoblog/shop/lister) you can specify

       optional c=  parameter (category name)  or  cid  (category id)  (notice: c parameter is case sensitive)

search period parameter (p) (optional)

p=0  any time

p=1  last 24h

p=2  last week

p=3  last year

notice: p parameter can only be used together with (t) parameter

(notice: you can replace spaces with + in q,m,c parameters) 

example:

documents/search.php?q=ezgenerator&id=142&c=General&t=p 

will search in page with id 142 in category general for string ezgenerator

TinyMCE is external editor from MoxieCode and is fully supported by all ezgenerator online pages.

It can replace include Innova Editor included inside EZGenerator.

To Install TinyMCE in ezgenerator follw this steps.

1. download latest version of tinyMCE from here  select "Main Package" (not jquery or development packages) and save it your pc

2. inside EZGenerator, go to project settings, advanced, select in "Online HTML Editor" TinyMCE and navigate to location where you saved package (1)

3. if you want to use additional languages (only english is include inmain package), go here and select languages you need in your project, then download and save package on your pc

4. use button 'install additional languages to install languages installed in (3)

5. you can now select languages same way as you do for innova editor (language bar --> editor language)

6. do Full Build to apply changes to all scripts in project

'

OR

Insert calendar box using Insert HTML (use this method, when adding calendar on single page)

• Go to the page where you want to insert the calendar box
• Select Insert HTML
• Paste the following code:

< script src="../folder/calendar_page.php?action=showcaljs" type="text/javascript">< /script>

Example: < script src="../documents/calendar.php?action=showcaljs" type="text/javascript">< /script>

• Open Page Settings panel for this page and go to Scripts/Page Background tab
• Paste the following code:

< link type="text/css" href="../ezg_calendar/XX_cal_textstyles.css" rel="STYLESHEET" title="Calendar">

Where XX is ID of your calendar page.

If page is in root, remove '../'.

You can find the page ID number by clicking on your page in EZG and looking right above the page settings tab (top left side) (in EZG4 it's on the bottom left hand side), where is says something like WEB Calendar [documents/calendar.php] [XX] --> that number is your page ID

!!! Make sure to remove the space between < and script/link

Since version 4.0.0.305 ezg supports two new CSS3 properties (box-shadow and border-radius) in some dialogs.

This properties are correctly handled by most recent browsers and by IE9. (but not with IE8 and lower)

Ezg use IE twebbrowser control which depends on IE installed on your pc, which means if you want to see this CSS3 properties displayed correctly inside ezg browse mode, you will have to install IE9 om your pc.

You can customize these colors through Template Editor dialog, the CSS tab.
Add 2 lines:
.chart_color1{...}
.chart_color2{...} 

Example:

.chart_color1{background:#323232;}
.chart_color2{background:#5c5c5c;}

Site search returns results in certain format - list of results, each with title set as link to the corresponding page in the site, content excerpt, date and url.

If you want to customize this default layout:

• add normal page in EZGenerator
• in the Treeview, right click on page and select "Use page as search template"

• 
  
  
• open Page Settings panel and check Hide in Menu, uncheck Hide in sitemap
• open Macros Field panel and drag-and-drop the macros you need

Example:

<SEARCH_BODY>

%HEADER%
%NAVIGATION%
%SEARCH_OBJECT(%counter% %title%

%content%

%date[dddd, mmmm d, yyyy]%

% category%
%url%

)%
%GENERATEDTIME%

</SEARCH_BODY>

%HEADER% will parse --> Results: searchstring

%NAVIGATION% will parse --> 1 2 3                    1 of 18 pages navigation

%SEARCH_OBJECT will parse short data for each page in result

%counter% --> number of page results

%title% --> page title of result

%date% --> last modification date of result page

% category% --> in case of blog, photoblog, podcast this parameter will parse post category; in case of other page - will pars ethe menu category

%url% --> url of the result page  --> this is url macro, to use it select any text or macro, make it hyperlink and use %url% as url for this hyperlink

%GENERATEDTIME% will parse --> Page generated in xxx seconds

If you have enabled Advanced search, you can also insert %ADVANCED_SEARCH_LINK% or %ADVANCED_SEARCH% macros.

The first one will build link to advanced search screen, the second one will directly insert advanced search form in the page.

multiple shops can be linked to single products database

in this example SHOPA is main shop with source products database and SHOPB is linked shop (will use products database from SHOPA). Also we will create new price field in SHOPA to use different prices for same products in SHOPB (this is not required, both shops can also use same prices)

follow this steps to link SHOPB to SHOPA:

1. in SHOPA, go to shop settings, data and add new field of type 'price', (in this example we will give it name price2)

2. in SHOPB, go to shop settings, settings and define LINKED ID property, Linked ID is internal Ezgenerator page ID of SHOPA, you can find this id on status bar:

3. to use price field, set 'Linked Price Field' to 'price2' (name of field we created in step 1), also you will have to replace all %price% macros on pages of SHOPB with macro %price2%

4. do upload and login to SHOPA first (to apply database changes), then to SHOPB

end...

how things works:

both shops use their own databases for orders/settings, but share products database from SHOPA

some things you have to know:

- all shop settings defined inside EzGenerator and in online administration are not shared between SHOPA and SHOPB (except for data)

- if you visit administration panel of SHOPB, you actually edit products from SHOPA

- stock information is shared between SHOPA and SHOPB

since version 4.0.0.459 you can limit products/items in shopB by using "limit by" option:

1. in SHOPA define new field (let's call it : "linked") of type boolean

2. in SHOPA set for all products which you want to use in SHOPB, value for field "linked" to TRUE (or YES)

3. in SHOPB settings select "linked" as "limit by" option