[boothole]

WebTemplates Hack by Logician

--- Version 3.7.x (This hack is for Vbulletin version 3.7.x and up only! For versions vb 3.6.x, 3.5.x, 3.0.x or 2.x see relevant hack threads.)

--- First time installation and upgrade from an old version is SAME except step 4. So you can follow the steps below for either scenario.

INSTALLATION : (Get the attachment below (in the "code" tags))

STEP 1- Upload all files under /forum/ directory to your server's forum directory.

This is where they be put:
/Forum Root/ => view.php, editors.php
/Forum Root/admincp/ => wt_wt.php, wt_wq.php, wt_export.php
/Forum Root/includes/ => wt_include.php
/Forum Root/includes/cron/ => wt_clear_logs.php
/Forum Root/includes/xml/ => cpnav_webtemplates.xml

STEP 2- Login Admin CP/Product Manager/Add-Import Product/ -> Tick "Allow Overwrite
" and Import the file named "product-webtemplates.xml"
(There are 2 XML files, please make sure you import the file named "product-webtemplates.xml"!)
(This steps installs webtemplates templates, phrases, settings to your vbulletin)

STEP 3- Close your browser, reopen it, relogin to your admin cp and you should to see "Logician's WebTemplates" in the left menu. Expand it and click "Export/Import", then "Upload Webtemplate .XML File", point the file named "webtemplate_export.xml".
(There are 2 XML files, please make sure you import the file named "webtemplate_export.xml"!)
(This step is to upload default webtemplates and webqueries to your webtemplate system)
(Many people are missing step 3 above while installing the hack so please make sure you didn't!)

STEP 4- (For first time installation! Skip if you are upgrading your version) In admin cp, click Scheduled Tasks/Add New Scheduled Task/ and enter this data:
varname : wtclearlogs
description : WebTemplate Clear Logs Cron
Title : WebTemplate Visitor Logs Purge
Day of the Week : *
Day of the Month : *
Hour : 3
Minute : 0
Active : Yes
Log Entries : No
Filename : ./includes/cron/wt_clear_logs.php
log phrase : [LEAVE EMTPY]
Product : Logician's WebTemplates

Click Save.

(This step was for setting up the vb cron which will purge your webtemplate visit logs in certain intervals)
You have now installed Logician's WebTemplates Hack, congratulations!

Here are some starters for you:

1- Your webtemplates admin cp is under vb admin cp "Logician's WebTemplates". You can access your webtemplates and webqueries list there, create new webtemplates, edit existing ones. (The admin accessing webtemplates should have 'can administer styles' permission)
2- You can test installation by visiting the test webtemplates which are in these URL:
http://www.your_site_url/forum/view.php?pg=test
http://www.your_site_url/forum/view.php?pg=test2

3- You can access certain settings in vb admin cp/options/webtemplate options. (Please do not start tweaking them before getting familiar with the hack)

4- You are STRONGLY suggested to read the short document "How to Create your First WebTemplate.txt" to see how easy it is to create a webtemplate if even you are total newbie.

5- For more in-depth information, please make sure you read "WebTemplates User Manual" that comes with the installation file for getting more info about this hack. You'll find that most of your potential questions are already covered in that document.

6- If you want to use SEO friendly WebTemplate URLs (eg. http://www.your_site_url/forum/view_test.htm), please first read user manual section "IV. How to Enable Search Engine Friendly WebTemplate URLs".

7- 3.7.x version of WebTemplates comes with some default Site Information page like "About Us" "Are you a New Member?", "Link Our Site", "Donate to our Site", "Site Privacy Policy", "Forum Rules and Etiquette", "Terms of Service and Legal Notices" etc. If you don't want to use them, you can set them as "Draft" in your admin cp/edit webtemplate section so nobody but admins can visit them. If you want to use them:
a) Please visit each of them and edit them according to your needs. Especially "About Us" and "Donate to our Site" webtemplates need your checking before making online.
b) You may like to link these pages in your header or footer so that visitors can find them. They already link eachother so linking one of them would be sufficient. To put such a link in your footer, edit your vbulletin footer template in style manager, find line:

 <if condition="$show['contactus']"><a href="$vboptions[contactuslink]" rel="nofollow" accesskey="9">$vbphrase[contact_us]</a> -</if>

And after that add:

<a href="view.php?pg=info_aboutus" accesskey="10">About Us</a> -

and click SAVE

Please do not delete "Powered by" Tagline under webtemplates pages without prior permission and click install if you install the hack.
Thank you, from vBulletin
__________________________________________________ ________________
__________________________________________________ ________________

How to create your first web template

I know newbies are usually overwhelmed by the scope and all the documentation when it comes to webtemplates and they don't know where to start after they installed the hack.

This small document will help you to create your first webtemplate and demonstrate how easy it is even for someone who has no knowledge about anything!

-----> Assuming you have already installed the hack, let's start creating our first webtemplates which will be a "About Us" Page:
1- Login to your vb admin cp. In the left menu, you'll see "Logician's WebTemplates" and under it there is a link named "WebTemplates". Click on it.

2- In the opened window, there is a link at the top right corner that says "Add a New WebTemplate", click on it.

3- You are now on the interface which you can create a new webtemplate. Enter these information for the given fields :

a) WebTemplate Name : aboutus
b) User Friendly Name : About Our Site
c) Category : Your Custom Pages
d) Parse Method : TEXT
e) WebTemplate Content : Hello $user_username! This is a demo page that tells who build this site, when and how. I can tell a long story here: blah blah blah blah ....
f) Using a Theme : Default Basic Theme
g) Header : Default Vbulletin Header
h) Footer : Default Vbulletin Footer

Leave all other fields as they are and click CREATE NEW WEBTEMPLATE button

4- Voila! You have a new webtemplate that automatically inherits your vbulletin skin, greets your visitors with usernames and shows page visits in who is online already published!
Visit and see: http://www.yoursite.com/yourforum/view.php?pg=aboutus
----> Now let's make a few changes so that you can also be familiar with edit webtemplate interface :
1- Login to your vb admin cp. In the left menu, you'll see "Logician's WebTemplates" and under it there is a link named "WebTemplates". Click on it.

2- In the opened window, find the webtemplate named "aboutus" and click EDIT next to it.

3- This is the interface where you can edit the content of your webtemplate, scroll to the bottom, find "Using a Theme?" and set theme as "Two Column Theme", then find "Disallowed Usergroups" and check "(COPPA) Users Awaiting Moderation" and "Unregistered" usergroups and SAVE your changes.

4- Now visit your webtemplate again and you'll see that;

a) Its appearance changed since you changed the theme it was using. It is now using a two column display.
b) If you log out or login as a member who is from COPPA usergroup, then visit the webtemplate, you'll see that you'll be denied access as unregistered and COPPA usergroups are set as "disallowed" for this webtemplate by you.
So you can easily set permissions for your webtemplates like this.

----> Now let's make a final tweak :

1- Visit the Webtemplate you created and at the end of page you'll see a "Edit This Page" link, click on it.

2- A new editor window will open up for you in which you can edit your webtemplate content (only content!) in vbulletin editor interface. You can use smilies, bbcode, even switch to WYSIWYG editor if it is enabled in your admin cp/vb options. I'm sure I don't need to tell more about this page as you are already familiar with it. Go ahead and edit your page, then click update. (Please keep in mind: WYSIWYG interface applies only if your webtemplate parsing is "TEXT".)

I believe I can not explain this simpler.

Enjoy!
Logician \\=^))
http://www.logician.org

closetlabs.com/forum/WebTemplates 3.7.00.zip