FULL INSTRUCTIONS FOR THE FLEXY TEMPLATE

The following instructions assume you've installed Textpattern 4.0.4 OK and you haven't altered anything or added any content. Where this affects the Flexy installation, you will be advised below as to what to do should you have made any changes. For brief instructions, please use 1nstructions.txt.


*******************
PRELIMINARIES 
*******************

1 Using your file transfer client, eg Filezilla, go to the root of your site (where there are 'files', 'images' and 'textpattern' folders). Create a new folder called '_templates'. Change its file attributes to 777, ie full access. (In Filezilla you right-click on the folder, choose file attributes and click all the boxes so it changes to 777). The _templates folder is essential to make installing Flexy easy. Otherwise it will take over an hour.

2 Create a new remote folder within _templates called flexy.

3 In your local Flexy folder you will find these folders: forms, images, pages, plugins, style, write. f t p forms, pages and style folders over into the remote flexy folder. Open your local images folder and f t p the contents over to the remote images folder. chmod it to 777.

4 Open 'switch.php' in your local Flexy folder and change "01010.org/flexy" to the url of your site, eg google.com or www.google.com Don't add any http. Save and then transfer switch.php to the root of your site. This file makes the style switcher work.

5 When done you should have the following directory structure: root of your site (with files, images, textpattern and switch.php) > _templates > flexy > forms, pages, style.

Now we can leave the f t p and go into the Textpattern admin


*********************
IN THE TXP ADMIN TAB 
*********************

1 Click the Preferences tab and use the following settings:

Permanent Link Mode: /section/title
Use Textile: Leave text untouched
Accept comments: yes
On by default: yes
Automatically append comments to articles: no

SAVE. 

2 Click Advanced and use the following settings:

Custom field 1 name  metadesc
Custom field 2 name  metakeyw
Custom field 3 name  topleft
Custom field 4 name  topright
Custom field 5 name  headwide
Custom field 6 name  headleft
Custom field 7 name  headmid
Custom field 8 name  headright
Custom field 9 name  two3col
Custom field 10 name twocol

title_no_widow *or* Prevent widowed words in article titles: no

SAVE.

3 Open the TXP Plugins tab. In your local Flexy plugin folder, you open the following files one by one with a text editor, select all and copy. Then return to the TXP Plugins textarea and paste. Then click Upload. Click Install. Under Active, change the No to Yes by clicking on it. The plugin is then installed. (Note that in Windows select all = Ctrl + A, copy = Ctrl + C, and paste = Ctrl + V)

# hcg_templates-0.3.txt - This is Bert Garcia's plugin which will make installing this template very easy.
# glx_h1_current.txt - This is Johan Nilsson's plugin which is used with navigation.
# zem_contact-0.6.txt - This is Alex Shiel's contact form plugin.
# upm_savenew.txt - This is Mary Fredborg's plugin. It is optional but you need it if you are going to use article templates.

If something does not install right, it is best to start again and repeat the process. Causes are usually something small like a dot or bracket missing when you copy.


*************************
IN THE TXP TEMPLATES TAB 
*************************

When you installed Bert's plugin, it will have created an extensions tab and a Templates tab within it. In here you can click a dropdown and see what templates are available to import. Flexy should be listed. If it is not, I'm afraid there's a problem with the preliminary f t p of the _templates folder or flexy folder or the file attributes so you'll have to check and redo where necessary.

Assuming it's OK, select Flexy and click Go. As if by magic, Bert's wonderful plugin makes a backup and then imports the Flexy forms, page templates and style sheets! This would take over an hour manually but only takes a couple of ticks with the plugin. Nice one, Bert!

It does not import the write folder contents and you will copy and paste three of these manually later. 


****************************
IN THE TXP PRESENTATION TAB 
****************************


***** SECTIONS *****

Default. Leave both these settings at Default.

about. Alter the about settings to the following:
Section name: about
Section title: ABOUT
Uses page: flexy_archive
Uses style: default
Selected by default? no
On front page? yes
Syndicate? yes
Include in site search? yes
**SAVE.**

article. Alter the settings to the following:
Section name: articles
Section title: ARTICLES
Uses page: flexy_archive
Uses style: default
Selected by default? yes
On front page? yes
Syndicate? yes
Include in site search? yes
**SAVE.**

Create some sections using this data. Make sure you Save after each individual section.

Section name: archives
Section title: ARCHIVES
Uses page: flexy_archive_list
Uses style: default
Selected by default: no
On front page: no
Syndicate: no
Include in site search: no
**SAVE.**

Section name: contact
Section title: CONTACT
Uses page: flexy_contact
Uses style: default
Selected by default? no 
On front page? no
Syndicate? no
Include in site search? no
**SAVE.**

Section name: sitemap
Section title: SITEMAP
Uses page: flexy_search
Uses style: default
Selected by default? no
On front page? no
Syndicate? no
Include in site search? no
**SAVE.**

Section name: template
Section title: ARTICLE TEMPLATE
Uses page: flexy_archive
Uses style: default
Selected by default? no
On front page? yes
Syndicate? yes
Include in site search? yes
**SAVE.**



******************************
IN THE TXP CONTENT TAB 
******************************

***** CATEGORIES *****

In Article Categories, click 'Hope for the Future' and change Article category name to nav and Article category title to nav. Change the other categories to 'list' and 'docs'. Create new categories - one called 'category' and one called 'templates'.

When you write articles you can assign 2 categories. Assigning 'nav' to an article will cause it to be added to the main navigation. Assigning 'list' will put it into a list of related articles at the end of an article. Note that the category called 'category' is there just for the sake of the breadcrumbs trail at the top of the page.

***** ARTICLES *****

You should see one article listed called 'First Post'. It should have an ID of 1. Click it so you can edit it. You are now in the Write tab. Click Advanced Options and look through the custom fields for one called 'twocol'. Type 'yes' in here (without the speech marks). On the right hand side change Category 1 to docs and Cat 2 to list. SAVE. 

***** WRITE *****

1 If the fields in the Write tab are not empty, click Create New. Please create the following 3 articles in the order specified and we are all done! Note: I refer to the three central text boxes at Title, Main Content and Excerpt. 

2 In your local Flexy folder, open the write folder and open 'front.txt'. Follow the instructions, copying, pasting and selecting where indicated. When published, go into the Articles tab and check the ID. 'front' is needed for the front page and should have an ID of 2. If it hasn't you will have to go into forms, open flexy_contentdef and alter id="2" to whatever your id is. Also open form flexy_side2def and do the same.

3 In the local Flexy write folder, open flexy.txt and follow the instructions again. When published check if the article id is 3. If not, then open the flexy_side2def form and change id="3" to whatever ID you have got.

4 In the local Flexy write folder, open access.txt and follow the instructions. 

5 The remaining documents in the write folder are optional. If you want to use article templates, then please copy Basic, Twocol and Two3col. The Guides are also there should you want them.

************  ALL DONE! ENJOY! ***************