Leaf

1 day ago: Installation Instructions

Preamble

I will be using Stuart's (of The Bomb Site) Installation Instructions as a base for my own.

Please visit my website!

We are going to be overwriting existing templates so you should make a back-up of them in case you want to return to them at a later date.

Page Templates

In the folder called "pages" you will find 2 text files. TXP comes with 2 page templates already, "default" and "archive". That is all I am using here though my versions have been modified somewhat.

In TXP go to "presentation/pages". This will normally show you the default page template. You can't delete this one so don't bother trying. What you can do is select all the text and delete it so you have an empty text box. Now open the "default page template.txt" file and copy/paste the whole thing into the text box and save it.

Now select the "archive" page and do the same thing using the "archive page template.txt" file as your source.

That's the page templates done!

Form Templates

In the folder called "forms" you should find 9 text files. I know that sounds a lot but it's a simple enough process. You will see that some of the forms already exist in your forms listing in which case you can follow the same procedure as you did for the page templates with one extra process which I will get to in a minute. For the new ones simply click on "Create new form" above the listing on the right and you will be presented with an empty text box to fill.

The difference between form templates and page templates is that you need to tell TXP what "type" of form it is so that it can parse it correctly. Below the main text box you will see 2 smaller boxes. The top one is for the Form name. The second one is for the Form type. Both are "required".

I have used a specific naming convention to name the form template text files included here.

First, all the files here end with the .txt suffix. You can ignore this completely. It is simply the type of file you are looking at. This Readme is a .txt file. In fact the only things that aren't are the image files.

The names of the forms are in a "form name () type" format. The first part of the name of the .txt file is the name of the form itself, while the part following the "()" is the form type.

Now just as you did with the page templates either overwrite any existing form templates or create new ones remembering to fill in the Form name and Form type boxes as well. If you are overwriting existing forms these boxes should already be filled in and I haven't changed these at all but do check! If you save a form without a name it will appear at the top of the form listing as a blank. You will not be able to select it. All you can do is delete and recreate it again. If you save a form with the wrong form type you will be able to change it and resave.

Sections

You do not need to modify the sections for the Leaf template!

Images

Simply upload the "images" directory directly into your installation, so that the images are in the directory containing your "index.php" and "textpattern" files.

CSS

Throughout Leaf it is assumed that you are using the default CSS file. Go to "presentation/style" and you will be shown the "default" CSS. Just as you did with the templates, delete everything that is in the text box then open up the default.txt file in the CSS folder here and copy/paste it into the text box then save it. Done.

The remaining styles are needed for the "text-resizing" and "nicetitle" features of this theme. For these, enter the name of the text file (ie. "large", or "medium") in the "Copy style sheet as" field and press "Copy". You MUST then click on the link that matches the name you just entered. So if you entered "nicetitle" and pressed "Copy", you would then have to scroll to the top of the page and select "nicetitle" from the list of "All Stylesheets". Then, simply copy the contents of the corresponding text file in the field and save.

Plugins

In the plug-ins folder I have included all the plug-ins used for Leaf.

In TXP go to "Admin/Plugins". At the top of the page is a text box. Open either of the files in the "plugins" folder in a text editor and copy the contents into the box. Now click on "Upload". Once TXP has loaded the file you will see a screen with lots of code on it. That's the plug-in code.

Next, scroll down the page and click on the "Install" button. You will now be taken back to the first page again where you will see the plug-in in the list. On the right you will see the word "No". Click on it and it will change to "Yes". You have just installed and activated a plug-in.

Repeat the process for both of the plugin files.

Other Stuff

The Leaf template requires the use of some Javascript, so you will also have to upload the "js" folder directly into your textpattern directory (Like we did with the "images" folder).

Other changes must also be done in a few of the forms.
Go to the "Presentation/Forms" area of the TXP administration and click on the "Temp_header" form. In it, you will see some links to the Javascript we just uploaded. However, you must change the path to the files so that they work all the time.
In "Temp_header", change both instances of "example.com" to your site's URL.

The next form you must modify is the "comments" form. On the first line, you will find some code calling on the If_Comment_Owner plugin. Change YourName and you@example.com to your actual name and email address.

<txp:ajw_if_comment_owner name="YourName" email="you@example.com">

That's it!, you're done.