Getting a template to work in 2.8

[doc]

Hi,

just for clarification because some things are mixed up in this thread.

Scenario 1: Missing index.php file (only modules)
Templates needs a index.php file in any WB version, as this file provides the HTML markup of the page.
Since WB 2.8 also MODULES require a "index.php" file in it´s module folder as explained in the Developer guide.

Scenario 2: Wrong ZIP file structure (all Add-ons)
The second possible issue with Add-ons (modules and templates) is a invalid ZIP file structure. On Mac OS for example, the Add-on folder is often included by default, which is not allowed and leads to invalid archive structure for WB. The zip file structure is shown here (compare column 6 "Pfad" of the two figures).

Scenario 1+2 lead to the WebsiteBaker error message: "Invalid WebsiteBaker installation file. Please check the *.zip format."

Scenario 3: Permissions
In this case your system has not the right permissions to create files in the /temp, /templates/, or the /modules folder. Per default Add-ons are uploaded as zip file to WB /temp folder. Here they will be extracted and checked (e.g. if info.php and index.php file exists). If correct a folder is created in /templates or /modules and the temporary files are copied over.

In case of insufficient file permissions, the installation process quits with another error message.
One option is to copy the Add-on files via FTP into their respective folders (/templates, /modules). In case of MODULES, one may need to invoke the "upgrade or install script" of the module manually. This steps needs to be excecuted, if the module provides an upgrad or install script, which alters the database entries.
After the manual upload, one should reload the Add-ons to get them listed in the WebsiteBaker overview.

However, preferred way to solve the permission issues is to set the required permissions via the admin panel of your webservice provider (if available) or to contact your provider in order to set the right permissions for you. The FTP option is a "workaround" which should only be used by experienced users knowing all the consequences coming along with mixing PHP and FTP uploads depending on server configurations

Doc

[rauni]

Wow. Thank you. Especially for the speedy reply.

[BerndJM]

Hi,

the most common error that causes this message is, that the zip-file is unpacked (either from the user or from the os) and after this is wrong packed again.
doc's talkin' about the index.php in the root of the zip.

You must pack only the files in the folder - not the folder with the files!

Example contet of "my_template.zip":

Code Select Expand


my_template
|--- index.php
|--- info.php
|--- template.css


Is wrong!

Code Select Expand


index.php
info.php
template.css


Is correct!

Also see here:
http://www.websitebaker2.org/en/help/designer-guide/creating-a-wb-template.php#anker3

Regards Bernd

[rauni]

Hey I'm REALLY new to WebsiteBaker and I've just installed the new 2.8.1 version on WebsiteBaker and to my surprise it was giving me that same error;

Invalid WebsiteBaker installation file. Please check the *.zip format.

And doc explained how to fix this, yet I have no clue what he is talking about? Root of Add-on? I saw index.php in both my "addon" and "module" folders on my site? Is there some sort of walk through to doing this? As I've never done anything like this.

I HIGHLY appreciate any help on this matter.

[doc]

Hi,

Invalid WebsiteBaker installation file. Please check the *.zip format.

This message indicates that an Add-on (template or module) does not include a index.php file in the root of the Add-on. An index.php file is required for all add-ons since WB 2.8.

Unzip the Add-on locally, add a dummy file called index.php to the root folder. Than zip the Add-on (without the Add-on folder) and try it again.

Doc

[PJW]

No, I didn't do anything other than download it.

Apologies to anyone who comes across this topic looking for a solution to the same problem, but as it was a fresh install I decided to start from scratch, so I deleted everything, including the database tables, then reinstalled.

Now I am back at 2.7, but I have the template installed

Thanks for replying erpe

Paul

[erpe0812]

Did you repack the template?
If yes: you must pack the template inside the directory.

rgds

erpe

[PJW]

Great.

Any idea what this error message that I'm getting means then:

Invalid WebsiteBaker installation file. Please check the *.zip format.

TIA,
Paul

[erpe0812]

Hi

just downloaded the template (andreas09) from the addons repository from your link and installed it on a 2.8 installation.
No problems 

rgds

erpe

[PJW]

Hi,

I did a test installation of WB 2.7 on a completely separate domain and liked what I saw.  I chose and installed a template and did some minor customization.

Before I was ready to install on the 'real' domain 2.8 was released, so I thought I'd go for the latest.

However, the template that I chose (http://addons.websitebaker.org/pages/templates.php?id=43&p=2) will not upload.  I get the error message:

Invalid WebsiteBaker installation file. Please check the *.zip format.

It's the same file I used to upload before and I've re-downloaded etc. anyway.

I checked out the help docs and this page () says:

...you still can install templates manually.
Using your favourite ftp client, upload the full, complete, unzipped directory into the "templates" sub-directory of your WB installation. Then, login into your Admin->Settings, click on "Show Advanced Options", and then use the "Reload Add-ons" tool to reload all templates. This will force WB to manually 'activate' the newly uploaded template

But I don't have a "Reload Add-ons" tool when I "Show Advanced Options" :/

So, I guess the template isn't compatible with 2.8.  Is there a way to make it compatible?  Or could the problem be something else?