Site Builder Software - Content Management System

Help File

Version 1.0 - The latest version is always available from www.softswot.com
Copyright © softSWOT

Register Site Builder Software to maintain this software and enable all features. Only registered software and code built using registered software will continue functioning.

Overview

Site Builder Software is a Content Management System allowing you to quickly and easily build a web site and add or modify site pages and content directly from your web browser. Site Builder Software includes a range of configurable variables to define site layout and using these generates php based Site Code which is uploaded to your server. This Site Code allows web pages and content to be managed from any browser by simply entering a password and selecting New Item or Edit.

You can use our online Site Builder Software version at Try Site Builder or Download Site Builder Software and run it on your computer to generate Site Code and build your web site. You will also need the files included in the download package from Download Site Builder Software for uploading to your server. For Site Code to run your server must support the php scripting language. Most commercial web servers support php. For information on php and how to check if it is available on your server goto What is php?.

There are two components to this application:

  1. The Site Builder Software which allows you to set variables applied to your site and generates the Site Code
  2. The Site Code that is generated by the Site Builder Software. This generated Site Code is uploaded to your server and provides a Content Management System allowing you to add and modify pages of your web site directly in a browser. You will also need the files included in the download package from Download Site Builder Software for uploading to your server.
Key Features

Please refer to our Example Site Builder Software Applications and Techniques for additional information and insight into the range of possibilities, features and functionality available.

Operation

Site Builder Software allows you to quickly build a valid dynamic web site. It automatically sets up navigation menus and requires no html knowledge.

Site Builder Software generates the Site Code for your site based on variable settings. The variables applied for the Site Code are set using the Site Builder Software input fields when the Site Code is generated or can be hard coded into the Site Code file by editing this file in a text editor, for details please refer to the Instructions for Use - Site Builder Software. The Site Code is then uploaded to your server. For the Site Code to run the server must support the php scripting language. The saved Site Code (usually saved as index.php to make it the default home page but can be named anything you like) and the software files style.css and sbspc.js must be uploaded to your server. Once uploaded you can open the Site Code file from your server (ie http:www.mydomain.com/index.php) in a browser.

The first time the Site Code file is opened the it will attempt to create a new directory in which the XML Item content files will be saved, the default name of this directory is sitexml. You can then Sign In and add a New Item to your site by simply typing a Title and Content into the text fields. When you Save the Title and Contents are saved as an XML file on your server in the new directory.

When an Item is displayed and the user is signed in Item Edit and Delete links are available. A New Item link is displayed whenever the user is signed in. If when you are signed in these links are not displayed at the bottom right of the page your browser may have cached the page and not be showing the current version. To reload a page and bypass the old cached page in Internet Explorer hold the Control key, and click the Refresh button on the toolbar, in FireFox hold the Shift key, and click the Reload button on the toolbar.

In standard mode each Item saved is treated as a web page and appears in the automatically generated menu as a link where the Item Title is displayed and the link includes the query ?item=The-Item-Title. Where The-Item-Title is the Title provided (ie The Item Title) for the item with any non-alphanumeric values (including spaces) replaced with a dash -. If the Site Code was saved as index.php on the root directory of the domain mydomain.com the full url for the Item would be http://www.mydomain.com/index.php?item=The-Item-Title. Please refer to the Instructions for Use - Site Code for full details.

Application

Site Builder Software provides a quick and easy to use solution to Web Site creation. It is suitable for anyone wanting to create and maintain a clean valid web site with ease. Starting with a basic Quick Site which can be further structured using a range of advanced features Site Builder Software provides extensive flexibility making it suitable for novices through to experienced professional web site developers. Applications include:

Instructions for Use - Site Buldier Software

While Site Builder Software can be run directly from our server at http://www.softswot.com/sitebuilder/sitebuilder.php it is recommended that you Download Site Builder - Content Management Software and Install it on your computer as you will need the files included in the download package for uploading to your server. Once installed open the Site Builder file (sitebuilder.html) in your web browser. To open click the file or from your browser go File, Open. JavaScript must be enabled for the software to function.

When the software is run a Control Menu is located at the top of the window. Registration displays the current registration status and provides links for secure online registration. If you have Registration Details input these before you start. Only registered software and code built using registered software will continue functioning.

Initially it is recommended that you build a Quick Site, and give it a test run on you server. To do this:

  1. From the Control Menu click Input.
  2. Input your Use Password value.
  3. Click Build Site Code.
  4. Select All of the Generated Output Code and copy it to a text editor.
  5. Save it as a file with a .php extension (i.e index.php). The file name can be anything you like, but when it is named index most servers will treat it as the default file to be displayed for the directory. Some servers require files to have the extension .php before they will execute php code. If using NotePad as your text editor when you Save, select Save As Type "All Files" and then provide the full File Name i.e "index.php" to ensure a .txt extension is not applied to the file.
  6. Upload the saved file (index.php), the CSS Style Sheet file (style.css), and the javascript script file (sbspc.js) to a directory on your server just like an ordinary web page. The upload directory can be the base www directory or sub directory. The permissions of the directory you upload to should be temporarily set to provide public write permission (rwx r-x rwx or 0757) so when the Site Code is initially run it can create a sub directory for the site xml files (your site content). Permissions can be set either using your site host control panel or an ftp client (cmod). The style sheet and javascript files are included in the Site Builder download and will be in the same location as the Site Builder software on your computer.
  7. Open the Site Code page (ie http://www.mydomain.com/index.php) in your browser and the XML content directory will be created, you can then return permissions to the original settings.
  8. Reload the Site Code page (ie http://www.mydomain.com/index.php), click Sign In on the right, input your Use Password value and submit.
  9. Click New Item on the right (if this is not displayed your browser may have cached the page. To clear this in Internet Explorer go Control/Refresh, in FireFox Shift/Reload), input an item Title and Content. Title will be used in the item web page title, with non alphanumeric characters replaced by a dash -. Content can be simple text or you can use the html buttons to add html. For an initial test simple text is usually best.
  10. Click Save and the item appears in the Menu on the left. You can now add New Items and Edit or Delete existing Items.

Once you have test run a Quick Site you can explore the range of features offered by the Site Builder Content Management System and build a web Site with the layout and features you want. Adjust Site Code variables using the Input fields and then Build Site Code or by directly editing the Site Code using a text editor. User Configuration Variables appear at the top of the generated Site Code and can be user defined by adjusting the values between each "" or by using Site Builder Software and re-building the Site Code. A description and outline of variables and their function are provided below.

Please refer to our Example Site Builder Software Applications and Techniques for additional information and insight into the range of possibilities, features and functionality available.

Input

Start here and set the input variables for your Site Code.

Site Password

These variables set your site password and how it is managed.

Use Password

Use Password
This is the password for editing your site and is the only required variable. The default values can be used for all other variables.

In the code a Use Password value of mypassword appears as $usePassWord = "mypassword";. If required this variable can be directly edited in the Output Code text area or using a text editor.

Quick Site

Once you have provided a Use Password value you can to generate a Quick Site using default values. Click Build Site Code to generate Site Code using the current variables and display it in the Output Text Area for saving and uploading to your server.

Use Cookies

Use Cookies
Check to allow the use of Cookies to remember the site password. This is usually the best password memory method, however will only function when Cookies are enabled and not blocked on your browser. The default setting is checked.

In the code this appears as $usePassWordCookie = "true"; when checked and as $usePassWordCookie = "false"; when not checked. If required this variable can be directly edited in the Output Code text area or using a text editor.

Cookie Days

Cookie Days
This is the number of days a password remembered as a Cookie will remain valid. If left empty the Cookie will expire at the end of the session or if you Sign Out and the password will need to be re-entered when a new session is commenced. If it is set then anyone using the computer will be able to modify the site. If you are using a shared computer then it should be left empty. It is only applicable if Use Cookies is selected and cookies are enabled. The default setting is empty.

In the code a Cookie Days value of 365 appears as $usePassWordCookieDays = "365";. If required this variable can be directly edited in the Output Code text area or using a text editor.

Use GET

Use GET
When checked the password can be passed using GET variables. Get variables appear as a query after a ? in a url and can be used in the form ?pw=mypassword, where mypassword is the required password. This method is not recommended as it will need to be included in the url of any edit function however it can be used when Cookies are not available. The default setting is not checked.

GET variables in urls are visible in the url and will appear in the browser history. In most cases they should only be used when computer access is limited to approved users or when public wiki style editing is desired. To set up a public wiki style site you can used the ?pw=mypassword query in the site access urls effectivly granting anyone who uses the link full site edit and modification rights.

In the code this appears as $usePassWordGet = "true"; when checked and as $usePassWordGet = "false"; when not checked. If required this variable can be directly edited in the Output Code text area or using a text editor.

Example:

Using GET to include the password mypassword for a site with the url http://www.mydomain.com/index.php the url is

http://www.mydomain.com/index.php?pw=mypassword

Use Sessions

Use Sessions
Check to allow the use of Sessions for password memory. This should only be used when it is not possible to use Cookies. Sessions are a way the server attempts to maintain memory during an access period. When checked session id's may be appended to the url as a query in the form ?PHPSESSID=*****. Sessions end when the browser is closed or is inactive and times out. To use this feature Session Support must be enabled in the server php configuration. The default setting is not checked.

In the code this appears as $usePassWordSess = "true"; when checked and as $usePassWordSess = "false"; when not checked. If required this variable can be directly edited in the Output Code text area or using a text editor.

Site Template

These variables set your site layout and format.

Color 1

Color 1
When provided this value is set as the body color, it is applied to text. It can be input as a defined color (ie black) or as a hex color value (ie #00000). W3Schools CSS Color Names lists allowable defined colors and hex color values. It over rides corresponding style sheet values. The default setting is empty.

In the code a Color 1 value of #00000 appears as $color1 = "#00000";. If required this variable can be directly edited in the Output Code text area or using a text editor.

Color 2

Color 2
When provided this value is set as the body background color, it is applied to the background. It can be input as a defined color (ie white) or as a hex color value (ie #ffffff). W3Schools CSS Color Names lists allowable defined colors and hex color values. It over rides corresponding style sheet values. The default setting is empty.

In the code a Color 2 value of #ffffff appears as $color2 = "#ffffff";. If required this variable can be directly edited in the Output Code text area or using a text editor.

Color 3

Color 3
When provided this value is set as the highlight color, it is applied to bold text, links and headers. It can be input as a defined color (ie navy) or as a hex color value (ie #000080). W3Schools CSS Color Names lists allowable defined colors and hex color values. It over rides corresponding style sheet values. The default setting is empty.

In the code a Color 3 value of #000080 appears as $color3 = "#000080";. If required this variable can be directly edited in the Output Code text area or using a text editor.

Color 4

Color 4
When provided this value is set as the border color, it is applied to borders. It can be input as a defined color (ie silver) or as a hex color value (ie #c0c0c0). W3Schools CSS Color Names lists allowable defined colors and hex color values. It over rides corresponding style sheet values. The default setting is empty.

In the code a Color 4 value of #c0c0c0 appears as $color4 = "#c0c0c0";. If required this variable can be directly edited in the Output Code text area or using a text editor.

Logo Image Url

Logo Image Url
When provided this url is used as the source of the logo image on all pages. It can be a full absolute url ie http://www.mydomain.com/images/logo.gif or a relative url /images/logo.gif and the image file must be uploaded to the server. The logo image and anchor are given the class logo and included in the Logo Division. The positioning and formatting for the class logo (.logo) and the Logo Division (div.logo) are set in the CSS Style Sheet file. The default setting is empty.

In the code a Logo Image Url value of http://www.mydomain.com/images/logo.gif appears as $logoImageUrl = "http://www.mydomain.com/images/logo.gif";. If required this variable can be directly edited in the Output Code text area or using a text editor.

Logo Link Url

Logo Link Url
When provided this url is used as the hyper link for the logo image on all pages. It can be an absolute or relative url. If empty it defaults to the base url of the Site Code. The default setting is empty.

In the code a Logo Link Url value of http://www.mydomain.com/ appears as $logoLinkUrl = "http://www.mydomain.com/";. If required this variable can be directly edited in the Output Code text area or using a text editor.

Logo Alternative Text

Logo Alternative Text

When provided this text is used as the alt (alternative) display for the logo image on all pages. It is also used as the channel description in the generated RSS feed for the site. The default setting is empty.

In the code a Logo Alternative Text value of Site Builder Software - Content Management System appears as $logoAltText = "Site Builder Software - Content Management System";. If required this variable can be directly edited in the Output Code text area or using a text editor.

Area HTML


When provided this html or text will be included in the Area Division on all pages. The positioning and formatting of the Area Division (div.area) is set in the CSS Style Sheet file. The default setting is empty.

In the code an Area HTML value of <h1>Site Builder Software</h1> appears as $areaHtml = "Site Builder Software";. If required this variable can be directly edited in the Output Code text area or using a text editor.

Footer HTML


When provided this html or text will be included in the Footer Division on all pages. The positioning and formatting of the Footer Division (div.footer) is set in the CSS Style Sheet file. The default setting is empty.

In the code a Footer HTML value of powered by Site Builder Software from <a href='http://www.softswot.com' >softSWOT</a> appears as $footerHtml = "powered by Site Builder Software from <a href='http://www.softswot.com' >softSWOT</a>";. If required this variable can be directly edited in the Output Code text area or using a text editor.

Display Print

Display Print
When checked a Print link will be displayed in the Footer Division on all pages. The Print link opens a new window that only includes the displayed item/s without the stlye applied for ease of printing. The default setting is checked.

In the code this appears as $displayPrint = "true"; when checked and as $displayPrint = "false"; when not checked. If required this variable can be directly edited in the Output Code text area or using a text editor.

Display XHTML

Display XHTML
When checked a Valid XHTML link will be displayed in the Footer Division on all pages. The Valid XHTML link uses the W3 validator to check the validity of the page XHTML coding. The default setting is checked.

In the code this appears as $displayXhtml = "true"; when checked and as $displayXhtml = "false"; when not checked. If required this variable can be directly edited in the Output Code text area or using a text editor.

Display CSS

Display CSS
When checked a Valid CSS link will be displayed in the Footer Division on all pages. The Valid CSS link uses the W3 CSS validator to check the validity of the CSS Styles applied. The default setting is checked.

In the code this appears as $displayCss = "true"; when checked and as $displayCss = "false"; when not checked. If required this variable can be directly edited in the Output Code text area or using a text editor.

Display RSS Feed

Display RSS Feed
When checked a RSS Feed link will be displayed in the Footer Division on all pages. The RSS Feed link provides the latest site changes in RSS format. The default setting is checked.

In the code this appears as $displayRssFeed = "true"; when checked and as $displayRssFeed = "false"; when not checked. If required this variable can be directly edited in the Output Code text area or using a text editor.

Display Sign In

Display Sign In
When checked a Sign In link will be displayed in the Footer Division on all pages. The Sign In link displays the Password Entry Form for site editing and modification. If this is not selected the Password Entry Form is accessed by adding the query ?pw to the base Site Builder file ie call the file index.php?pw . The default setting is checked.

In the code this appears as $displaySignIn = "true"; when checked and as $displaySignIn = "false"; when not checked. If required this variable can be directly edited in the Output Code text area or using a text editor.

Item Sort By

Item Sort By
Select the Sort By order of items, this is the order applied for Items in pages and in the Item Menu when used. Order options include created by the date items were created, modified by the date items were last modified, name by the alphanumeric order of the item title. The default selection is created.

In the code this appears as $itemSortBy = "created";. If required this variable can be directly edited in the Output Code text area or using a text editor.

Item Reverse Order

Item Reverse Order
When checked the Item Sort By order is reversed. The default setting is not checked.

In the code this appears as $itemReverseOrder = "false"; when not checked and as $itemReverseOrder = "true"; when checked. If required this variable can be directly edited in the Output Code text area or using a text editor.

Item Default

Item Default
When provided this Item will be set as the default item displayed when no item is specified. This can be used to set the displayed item for the base url of the Site Code ie if the the Site Code is saved as index.php then index.php will display the default item. If no default is provided but an Item Menu is selected the default item will be the first item in the Item Menu. The default setting is empty.

In the code an Item Default value of Welcome appears as $itemDefault = "Welcome";. The value used should be the Item name as displayed in the query, in the query all non-alphanumeric characters (including spaces) are replaced by a dash (-). So for an item titled Contact Us enter Contact-Us as the Item Default value. If required this variable can be directly edited in the Output Code text area or using a text editor.

Hour Offset

Hour Offset
When provided this value is used as the time offset in hours from GMT/UTC (Greenwich Mean Time / Universal Time Constant) for the last updated time and this will be displayed in the Time Division (div.time) at the bottom of each item. If left empty no last updated time will be displayed. This value should be a positive or negative decimal number. To display GMT/UTC time the value is 0. The default setting is 0.

In the code this appears as $hourOffset = "0";. If required this variable can be directly edited in the Output Code text area or using a text editor.

RSS Title

RSS Title
When provided this is the Title applied to the generated RSS feed of the the latest site changes and the site pages will include an application/rss+xml link within the head section of each page to identify the rss feed for the site. If left empty no application/rss+xml link will be placed in the head section of site pages. The default setting is Latest Items.

In the code this appears as $rssTitle = "Latest Items";. If required this variable can be directly edited in the Output Code text area or using a text editor.

RSS Item Characters

RSS Item Characters
This is the length in characters of each item in the RSS feed. The default setting is 200

In the code this appears as $rssItemCharacters = "200";. If required this variable can be directly edited in the Output Code text area or using a text editor.

RSS Item Per Channel

RSS Item Per Channel
This is the number of items in the RSS feed. The default setting is 6

In the code this appears as $rssItemPerChannel = "6";. If required this variable can be directly edited in the Output Code text area or using a text editor.

These variables set your site menu layout.

Item Menu Layout

Item Menu Layout
Select the Item Menu Layout. Options include vertical which places menu items one under the other, horizontal which places menu items side by side across the page, or none which does not display an Item menu. The default selection is vertical. The Item Menu is included in the Menu Division on all pages. The positioning and formatting of the Menu Division (div.menu) is set in the CSS Style Sheet file.

In the code this appears as $itemMenu = "vertical";. If required this variable can be directly edited in the Output Code text area or using a text editor.

Item Menu Pre Html


When provided this html or text will be included at the start of the Menu Division (before any Item Menu) on all pages. The positioning and formatting of the Menu Division (div.menu) is set in the CSS Style Sheet file. The default setting is empty.

In the code a Item Menu Pre Html value of Item Menu appears as $itemMenuPreHtml = "Item Menu";. If required this variable can be directly edited in the Output Code text area or using a text editor.

Item Menu First Files

Item Menu First Files
When provided these files or urls will be the first links listed in the Item Menu. This allows the first portion of the Item Menu to be fixed. Multiple files/urls must be separated by commas (,). They may be relative or absolute ie http://www.mydomain.com/, news.php, http://www.someotherdomain.com/ . For each file/url included there must be a corresponding Item Menu First Title. The default setting is empty.

In the code an Item Menu Pre Html value of http://www.mydomain.com/ appears as itemMenuFirstFiles = "http://www.mydomain.com/";. If required this variable can be directly edited in the Output Code text area or using a text editor.

Item Menu First Titles

Item Menu First Titles
These are the Titles that will be displayed in the Item Menu for the Item Menu First Files. Multiple titles must be separated by commas (,) ie Home, Current News, Some Other Domain . For each title included there must be a corresponding Item Menu First File. The default setting is empty.

In the code an Item Menu First Titles value of Home appears as itemMenuFirstTitles = "Home";. If required this variable can be directly edited in the Output Code text area or using a text editor.

Item Menu Last Files

Item Menu Last Files
When provided these files or urls will be the last links listed in the Item Menu. This allows the last portion of the Item Menu to be fixed. Multiple files/urls must be separated by commas (,). They may be relative or absolute ie contactus.php, http://www.myotherdomain.com/ . For each file/url included there must be a corresponding Item Menu Last Title. The default setting is empty.

In the code an Item Menu Last Files value of contactus.php appears as itemMenuLastFiles = "contactus.php";. If required this variable can be directly edited in the Output Code text area or using a text editor.

Item Menu Last Titles

Item Menu Last Titles
These are the Titles that will be displayed in the Item Menu for the Item Menu Last Files. Multiple titles must be separated by commas (,) ie Contact Us, My Other Domain . For each title included there must be a corresponding Item Menu Last File. The default setting is empty.

In the code an Item Menu Last Titles value of Contact Us appears as itemMenuLastTitles = "Contact Us";. If required this variable can be directly edited in the Output Code text area or using a text editor.

Item Menu Post Html


When provided this html or text will be included at the end of the Menu Division (after any Item Menu) on all pages. The positioning and formatting of the Menu Division (div.menu) is set in the CSS Style Sheet file. The default setting is empty.

In the code a Item Menu Post html value of Copyright © www.mydomain.com appears as $itemMenuPostHtml = "Copyright © www.mydomain.com";. If required this variable can be directly edited in the Output Code text area or using a text editor.

Item Menu Excluded Items

Item Menu Excluded Items
When provided these Items will not be automatically displayed in the Item Menu. This is used to prevent duplicate listing of items that have already been specifically included, to prevent the default item being listed as the base site url and as an item, or simply remove items that are not required in the Item Menu. Multiple items should be separated by commas (,) and each item must appear as in the query url for that item with any spaces replaced by a dash (-) ie Home,Not-In-Menu . The default setting is empty.

In the code an Item Menu Excluded Items value of Home appears as itemMenuExcludes = "Home";. If required this variable can be directly edited in the Output Code text area or using a text editor.

Page Menu
When checked items will be arranged in Pages and a Page Menu will be include when the base url or a page file is displayed. A Page Menu consists of forward and backward page links. When a single Item is displayed no Page Menu is included. The Page Menu is included in the Page Menu Division and the positioning and formatting of the Page Menu Division (div.pagemenu) is set in the CSS Style Sheet file. The default setting is checked.

In the code this appears as $pageMenu = "true"; when checked and as $itemReverseOrder = "false"; when not checked. If required this variable can be directly edited in the Output Code text area or using a text editor.

Items Per Page

Items Per Page
Select the number of items on each Page. The default selection is 1.

In the code this appears as $itemPerPage = "1";. If required this variable can be directly edited in the Output Code text area or using a text editor. Editing in this manner also allows values greater than 10 to be applied.

Pages Per Group

Pages Per Group
Select the number of forward and backward page links displayed in the Page Menu. The default selection is 10.

In the code this appears as $pagePerGroup = "10";. If required this variable can be directly edited in the Output Code text area or using a text editor. Editing in this manner also allows values greater than 10 to be applied.

Build Site Code


Build Site Code generates Site Code using the current variables and displays it in the Output Text Area for saving and uploading to your server.

Output

This section displays the generated output based on the input values set.

Generated Output

The generated Site Code is displayed in the text area. Select and copy this output to a text editor and save as a file with a .php extension ie index.php. Then upload the saved file, the CSS Style Sheet file (style.css), the javascript script file (sbspc.js) to a directory on your server. The permissions of this directory should be set to rwx r-x rwx (0757) so when the site code file is run on your server it can create a directory for the site xml files (your site content). Once this directory has been created by the site code you can return permissions to the original settings. Then open the site code file on your server in a browser and add items to your site.

Do not use a html editor for any of this process as the php code maybe corrupted. Only a text editor should be used. It is recommended that any file that includes php code be saved with a .php extension (i.e index.php). Some servers require files to have the extension .php before they will execute php code within the file. If using NotePad as your text editor when you Save, select Save As Type "All Files" and then provide the full File Name i.e "index.php" to ensure a .txt extension is not applied to the file.

Select All

Selects all the contents of the text area.

Clear Output

Clear generated output code from text area.

Help

Open the online Help file in a new window.

Registration

Access registration and support details.

Displays registration status and links for registration. Register software using the secure online payment link. Registration details are sent by return email and will enable all functions. Once registered the current registration and an Upgrade to Additional Licenses link are displayed. Only registered software and code built using registered software will continue functioning.

softSWOT.com

Go to software developer web site, www.softswot.com.

Instructions for Use - Site Code

Once you have generated the Site Code using the Site Builder Software upload the saved Site Code file (ie index.php), the CSS Style Sheet file (style.css), and the javascript script file (sbspc.js) to your server just like an ordinary web page. The upload directory can be the base www directory or sub directory. If you are developing a complete site and want the url http://www.mydomain.com/ to run the Site Code (to display your site) the Site Code file should be named index.php (for most servers) and uploaded to the server root public directory (often called www, http, or the domain name). Also if there is an existing index.html or index.htm file in this directory it may need to be renamed/removed for the index.php file to run as the directory home page. Keep in mind that uploaded files may overwrite existing files in the directory if they have the same name. The permissions of the directory you upload to should be temporarily set to provide public write permission (rwx r-x rwx or 0757) so when the Site Code is initially run it can create a sub directory for the site xml files (your site content). Permissions can be set either using your site host control panel or an ftp client. The style sheet and javascript files are included in the Site Builder Software download and will be in the same location as the Site Builder Software on your computer.

Then open the Site Code page (ie http://www.mydomain.com/index.php) in your browser and the xml directory will be created, you can then return permissions to the original settings. Reload the Site Code page (ie http://www.mydomain.com/index.php).

Sign In

If Display Sign In is checked (set as true) in the Site Code a Sign In link will be displayed at the the right of the page. Click this to Sign In. If the Sign In link is set not to display add ?pw to the end of the base url (this will be displayed in your browser address bar) and refresh/reload the page ie http://www.mydomain.com/index.php?pw.

An input field is then displayed, input the Use Password value set in the Site Code and click submit.

If Use GET is checked (set as true) in the Site Code you can also sign in by adding the password as a query at the end of the base url in the form http://www.mydomain.com/index.php?pw=mypassword .

Once signed in Administration Links (New Item - Refresh - Draft - Sign Out - Administration) are displayed at the bottom right of the page. Item Links (Edit - Delete) are located at the bottom right of each displayed Item.

If you Sign In but no Administration Links are displayed your browser may have cached the page and not be showing the current version. To reload a page and bypass the old cached page:

New Item

Once signed click New Item to add an item. Clicking New Item displays the edit page with Title and Content input fields.

New Items can also be created by adding an action=edit query at the end of the base url in the form http://www.mydomain.com/index.php?action=edit or an item query at the end of the base url in the form http://www.mydomain.com/index.php?item=some-none-existent-item . If you are signed in and call the edit query url the edit area with a new item titled Draft is displayed. If the item query url is called the edit area is displayed with the new item title some-none-existent-item . If you are not logged in and Use GET is true you can sign in and open a new item using http://www.mydomain.com/index.php?action=edit&pw=mypassword or http://www.mydomain.com/index.php?item=some-none-existent-item&pw=mypassword .

Refresh

Refresh reloads/refreshes the current page. This updates your page display. If the display does not appear to be current you may need to do a forced refresh

Draft

Clicking Draft opens the Draft Item as set by the Item Draft variable. The Draft Item does not appear in any menu structures and can be used as a temporary storage for work in progress.

The Draft Item can also be accessed by adding an item=Draft query at the end of the base url in the form http://www.mydomain.com/index.php?item=Draft

Sign Out

Signs the user out.

Sign Out can also be achieved by adding a pw=signout query at the end of the base url in the form http://www.mydomain.com/index.php?pw=signout

Administration

Clicking Administration opens the Administration Item as set by the Item Administration variable. The Administration Item does not appear in any menu structures and can be used as note pad item. While the Administration item is not linked from any menus and can only be displayed as an Item when the user is signed in it is possible for a non authorized user to view the Administration content xml file. As such it provides low level security and should not be used for highly confidential information. For confidential information an alternative such as Password Page Protection should be employed. From the Administration Item you can then link to fully protected pages.

The Administration Item can also be accessed by adding an item=Administration query at the end of the base url in the form http://www.mydomain.com/index.php?item=Administration

Title

The edit page displays Title and Content input fields. The Title field is at the top of the edit area, the default Title value is Draft. The Title value appears as the first header (h1) on the page when the item is displayed, it is the text displayed for the Item link in an automatically generated Item Menu and is the first part of an automatically generated item page title Meta tag value (ie the page title displayed at the top of the browser window). The Item Title with any non alpha-numeric characters replaced with a - is used to identify the required Item in the item url ie index.php?item=Draft and is also used as the item xml file name it is saved as in the site xml folder ie Draft.xml.

While the Title is left as Draft the Item is saved in draft mode and is not automatically displayed in any Menu. This allows you to edit the Item before it is displayed on the site. A Draft Item can be saved and later displayed/edited using the Draft administration link. There can only be one Draft Item at any time. A new Draft Item will overwrite any previous Draft.

For an Item to be displayed on the site replace the Title value with the desired Title for the Item. The title should generally be reasonably short (as it appears in the Item Menu), should be descriptive (as it is used as the highest level header on the page and as part of the page title), and once non alpha-numeric characters are replaced with - 's should be different to other item titles. For example an item title Jan/Feb will be the same as Jan:Feb and the same as Jan-Feb. When the alpha-numeric characters are replaced by a - they all become Jan-Feb and when saved will replace the prior Jan-Feb item.

Once saved an Item can always be accessed by adding an item=Item-Title query at the end of the base url in the form http://www.mydomain.com/index.php?item=Item-Title

Content

In the Content text area you can input simple text or use the xHTML buttons to add html. When an item is displayed on the site the Content appears below the Title on the page. The first sentence of the Content (ie all the characters in the Content up to and including the first full stop) is used as an automatically generated Description Meta tag value. This sentance is also used in as an automatically generated item page title Meta tag value in the form Item Title - First Sentance.

Any line breaks in the Content text area are converted to html line breaks when displayed.

Hyper-links will be automatically created for any text that starts with http:// , https://, ftp:// or www. . All characters from the start of this pattern to a space are treated as the anchor href link value. To display a url without having it automatically convert into a hyper link simply place a non-space character at the start of the url ie .http://www.softswot.com/ . To have complete control over the link href and the displayed text use the a xHTML tag.

Any character combinations that have special meaning within html are converted to their html encoded form before they are saved or displayed. This ensures that characters are correctly rendered and improves the validity and standards compliance of the site. The only character combinations that are not encoded are those used for the allowed xHTML tags. Allowed xHTML tags are displayed as buttons above the Content text area. To display a valid xHTML tag in an Item insert a space after the tag <'s and it will be encoded and displayed as text.

When editing you can use the Spell Checker in the free Google Toolbar to check spelling before you save the Item. The Google Toolbar is available for both Internet Explorer and FireFox browsers. Item content can also be composed and copied form a text editor, a html editor, emails or other applications.

xHTML Tags

When you edit valid xHTML tags are provided above the Content text area. These can be used to add set xHTML tags to your Content. Only the xHTML tags displayed can be used all other tags will be treated as text.

To use these tags position the cursor in the Content text area at the location the tag should be inserted, our highlight the text in the text area the tag should encompass. Then click the required xHTML Tag button.

Site Code pages are designed to be valid XHTML, which is the recommended document format for web pages. Valid XHTML tags consist of a start tag ie <b> and a corresponding end tag </b> or are a single tag including a / at the end ie <br />. All tags should be lower case.

Header 2 Tag <h2>h2 style</h2> Text between these tags is displayed in the format set by the

h2 style

in the Style Sheet.

Header 3 Tag <h3>h3 style</h3> Text between these tags is displayed in the format set by the

h3 style

in the Style Sheet.

Bold Tag <b>b style</b> Text between these tags is displayed in the format set by the b style in the Style Sheet.

Italics Tag <i>italics style</i> Text between these tags is displayed in italics style.

Paragraph Tag <p>Displayed Text</p> Text between these tags is displayed based on the paragraph style in the Style Sheet. A paragraph is a block formatting style. Block formatting separates the formatted content from the preceding and following content.

Div Tag <div>Displayed Text</div> Text between these tags is displayed based on the div style in the Style Sheet. A div is an block formatting style. It is commonly used with a class attribute to provide a range of formatting styles and positioning.

Span Tag <span>Displayed Text</span> Text between these tags is displayed based on the span style in the Style Sheet. A span is an inline formatting style. It allows formatting to be applied a selection of text. It is commonly used with a class attribute to provide a range of formatting styles.

Anchor Tag <a href="http://www.softswot.com/">Displayed Text</a> Text between these tags is displayed as a hyper-link with the url for the link as the href value (between the " " 's). Formatting is based on the a style in the Style Sheet. When the attribute target="_blank" is added (ie <a href="http://www.softswot.com/" target="_blank">Displayed Text</a>)the link will open in a new window.

Ordered List Tag <ol></ol> Text in List Item Tags <li></li> between these tags is displayed as a list with each item numbered. Formatting is based on the ol style in the Style Sheet.

Unordered List Tag <ul></ul> Text in List Item Tags <li></li> between these tags is displayed as a list with out ordering ie no numbers. Formatting is based on the ul style in the Style Sheet.

List Item Tag <li></li> Text between these tags is displayed as a list. Formatting is based on the li style in the Style Sheet.

Table Tag <table></table> Text in Table Data Tags <td></td> within Table Row Tags <tr></tr> between these tags is displayed as a table. Formatting is based on the table style in the Style Sheet.

Table Row Tag <tr></tr> Text Table Data Tags <td></td> between these tags is displayed as a table. Formatting is based on the tr style in the Style Sheet.

Table Data Tag <td></td> Text between these tags is displayed as a table. Formatting is based on the td style in the Style Sheet.

Image Tag <img src="http://www.softswot.com/images/logo.gif" alt="softSWOT Logo" /&glt; This displays an image with the image source url as the src value (between the " " 's) and the alternative txt for the image as the alt value. Formatting is based on the img style in the Style Sheet.

Script Tag <script type="text/javascript" src="script.js"></script> This includes an external JavaScript file within a page with the source file as the src value (between the " " 's).

Question and Answer Tag

<a href="javascript:void(0);" onclick="javascript:useNode=document.getElementById('1164182262734');curDisplay=useNode.style.display;if(curDisplay=='none'){useNode.style.display='block';}else{useNode.style.display='none';}return false;">
Q:
</a>
<span id="1164182262734" style="display: none">
A:
</span>

This is a specialized tag designed to display a clickable Question and only display the Answer once the Question has been clicked. The Question Text is place after or in place of the Q: and the Answer text is placed after or in place of the A:.

Class Attribute Selecting the Class check box adds a class attribute to inserted tags ie <div class=""></div>. A class attribute allows an element to be identified and is used in conjunction with the Style Sheet to provide specific formatting. The class value is added between the " " 's. A div tag the with class display appears as <div class="display"></div> and is formatted by the div.display style in the Style Sheet.

Example Site Builder Software Applications and Techniques provides additional information on the features and functionality available.

Save

Saves the Item. Items are saved as xml files in the XML Directory with the file name Item-Title.xml where Item-Title is the Title of the Item with non alpha-numeric characters replaced with a -. This file can be directly viewed in a browser ie http://www.mydomain.com/sitexml/Item-Title.xml .

Select All

Selects the contents of the Content text area. This can be copied to a text editor or other medium and saved as a text file for item backup and reuse.

Home

Link to the base Site Code url.

Auto Save

Auto Save When selected the Item will be automatically saved every Auto Save Seconds. It is saved as the Item Title and the time of the last Auto Save is displayed. Auto Save is stopped if unchecked.

Save As Local File

Clicking Save As Local File writes the text in the Content text area to a small new frame within a green box. This copies the current Content text to the frame and the Content updated time is displayed showing the time of last copy. To save the content as a local file right click the frame in the green box. Then in Internet Explorer select View Source, and the content text is displayed in the text editor, from the text editor select File Save As and save it to your local computer as a text file using the .txt extension ie Item-Title.txt. Or in FireFox select This Frame, View Frame Source to display the content text, from here select File, Save Page As and save it to your local computer as a text file using the .txt extension ie Item-Title.txt. For easy identification the name of the text file should be the same as the file name for the item xml file except with a different extension.

This provides a local back up copy of your Item. Should the XML content files on your server be lost you will be able to restore your site from the saved text files. To restore an item enter Edit mode for the Item Title, open the backup text file, copy the backup text to the Contents text area and Save.

A back up of XML content files is also possible using ftp or your site server control panel by simply copying all the XML Directory files to your local computer.

Edit

Edit links are displayed below each Item if signed in. When clicked the Item edit Title and Content fields are displayed.

An Item can also be edited by adding an action=edit query at the end of the Item url in the form http://www.mydomain.com/index.php?item=Item-Title&action=edit

Delete

Delete links are displayed below each Item if signed in. When clicked the Item Delete Confirmation prompt is displayed, when confirmed the Item is deleted. This action is not reversible. If JavaScript is disable no Item Delete Confirmation is provided and the Item is immediately deleted.

An Item can also be deleted by adding an action=delete query at the end of the Item url in the form http://www.mydomain.com/index.php?item=Item-Title&action=delete

Print

Opens a new window and displays the current page Items with standard browser formatting for easy printing. The Print link is only displayed when the Display Print variable is set.

Valid XHTML

Automatically validates the XHTML code in the current page using the W3C Markup Validation Service. This provides a quick and easy method of checking page validation against the current web standard. Using valid pages ensures that they will display as desired in current and future browsers. It also increases page suitability for search engines and supports the development of consistent web standards. The Valid XHTML link is only displayed when the Display XHTML variable is set.

Valid CSS

Automatically validates the CSS code in your site and page using the W3C CSS Validation Service. This provides a quick and easy method of checking Cascading Style Sheet validation against the current web standard. Using valid CSS enhances page display in current and future browsers. The Valid CSS link is only displayed when the Display CSS variable is set.

RSS Feed

Displays the latest site changes in RSS format. An RSS Feed can be submitted to RSS feed sites, linked to by users and displayed directly on your site by using the RSS Include Mark. The RSS Feed link is only displayed when the Display RSS Feed variable is set.

XHTML Design

All web pages are designed using tags that tell the displaying agent (the browser) how to display the page. HTML tags were originally used for this purpose and they were (and still are) often combined with attributes to modify the way pages are displayed. Due to the lack of separation between content and style, loose standards and the use of proprietary tags standard HTML was less than ideal particularly when attempting to develop web pages that display consistently across a wide range of browsers. These issues contributed to the development of XHTML by the web standards organization the World Wide Web Consortium (W3C). The use of XHTML for web pages became a W3C Recommendation on January 26, 2000. XHTML displays correctly in all current browsers, it is based on HTML and designed to replace it. All web development should undertaken using XHTML, however some HTML editors and web developers still use superseded HTML coding.

Site Builder Software builds Site Code that is valid XHTML ensuring your pages display correctly both now and in the future. You do not need to understand XHTML (or even HTML) to develop valid XHTML pages using the Site Code generated by Site Builder Software, simply type in your text and if desired use the defined xHTML tag buttons.

CSS Style

Cascading Style Sheets (CSS) are a key component in separating content from style. Using CSS formatting and positioning elements on a web page can be finely controlled and easily adjusted.

Site Builder Software Site Code uses an external CSS File to provide a site wide template. Changing site layout or formatting is simply an adjustment in the CSS file.

You can learn more about CSS at W3Schools CSS Tutorial and our Example Site Builder Software Applications and Techniques site.

Advanced Configuration Variables

These variables can only be set by direct edit in the Site Code once it has been generated. They are only required for advanced site configuration. Advanced Configuration Variables appear below the User Configuration Variables in the generated Site Code

Example Site Builder Software Applications and Techniques provides additional information on the features and functionality available.

Use Static Item

When provided this value will be used as the source file name (ie contactitem.php) for static content to be included in the web page. It should be a file containing valid web page body code (ie not a complete web page). It can be html, php or any other format. The static file should be uploaded to the same directory as the base Site Code. The default setting is empty.

This variable allows static html to be included within the base site template. It is commonly used for pages that will not be edited such as Contact Us forms. Static content is included in the Display Division the same as an Item. The positioning and formatting of the Display Division (div.display) is set in the CSS Style Sheet file.

In the code this appears as $useStaticItem = "";. This variable can only be edited in the Output Code text area or using a text editor.

Use Title

When provided this value will be used as a static Title Meta tag value for the web page. The default setting is empty. When this value and its corresponding Alternate Variable are empty Title Meta tag value is automatically generated from the item Title followed by a dash and then the first sentence of the Content (ie all the characters in the Content up to and including the first full stop).

In the code this appears as $useTitle = "";. This variable can only be edited in the Output Code text area or using a text editor.

Use Description

When provided this value will be used as a static Description Meta tag value for the web page. The default setting is empty. When this value and its corresponding Alternate Variable are empty the Description Meta tag value is automatically generated from the first sentence of the Content (ie all the characters in the Content up to and including the first full stop).

In the code this appears as $useDesc = "";. This variable can only be edited in the Output Code text area or using a text editor.

Use Keywords

When provided this value will be used as a static Keywords Meta tag for the web page. The default setting is empty. When this value and its corresponding Alternate Variable are empty the Keywords Meta tag value is automatically generated from the Content using the Advanced keyword variables.

In the code this appears as $useKw = "";. This variable can only be edited in the Output Code text area or using a text editor.

CSS File

This is the external Cascading Style Sheet applied to set the web site layout and formatting. It can be an absolute or relative file name. The default setting is style.css.

In the code this appears as $cssFile = "style.css";. This variable can only be edited in the Output Code text area or using a text editor.

Icon File

This is the icon file applied to the web site. It can be an absolute or relative file name. The default setting is favicon.ico.

In the code this appears as $iconFile = "favicon.ico";. This variable can only be edited in the Output Code text area or using a text editor.

Script File

This allows user defined JavasScript to be included in the dynamic pages. Included in the software package is a file script.js, add any required javascript functions to this file and upload it to your server. Then set $scriptFile="script.js"; and the functions will be available to the Site pages. The default setting is empty.

In the code this appears as $scriptFile = "";. This variable can only be edited in the Output Code text area or using a text editor.

Onload Function

This allows user define JavasScript OnLoad Function that will be executed on page body load. It works in conjunction with the script.js file which includes a default function called itemLoaded. To use this function set $onloadFunction="itemLoaded". The itemLoaded function checks to see the Item Title of the loaded page, to have a specific function run for a specific item adjust the itemLoaded function for the title and required function. The default setting is empty.

In the code this appears as $onloadFunction = "";. This variable can only be edited in the Output Code text area or using a text editor.

RSS Source File

When provided this file will be applied as the RSS source for the web page. This should be the file name of Site Code (ie news.php) located in the same directory as the base Site Code. This is used to set up a site that has a dynamic news page and apply the RSS feed of the news page to whole site. If empty the RSS Source is based on the base file. The default setting is empty.

In the code this appears as $rssSourceFile = "";. This variable can only be edited in the Output Code text area or using a text editor.

Item Menu Rewrite Extension

This converts dynamic urls in the Item menu to static urls with the Item Menu Rewrite Extension. To for the Item Menu link to be a static .html page instead of dynamic .php page set Item Menu Rewrite Extension to .html. To use this feature URL Rewriting must be set in the .htaccess file, if not the menu links will not be valid. Only use this feature if you are confident in your understanding of rewriting and .htaccess files. If you are uncertain it is recommended that this variable be left empty. The default setting is empty.

In the code this appears as $itemMenuRewriteExt = "";. This variable can only be edited in the Output Code text area or using a text editor.

Html Full

When set as true the Site Code to generates a complete stand alone web page. This is the normal structure applied for a web site. When set as false only the item content is output allowing the page to be included within an already existing web page. The default setting is true.

To include the content within an existing web page or web page template open the page or template in a text editor and at the location you what the content displayed add the following <?php include("index.php") ?> where index.php is the name of the base Site Code file. Both files should be uploaded to the same directory.

In the code this appears as $htmlFull = "true";. This variable can only be edited in the Output Code text area or using a text editor.

XML Directory

This is the directory that will be created for saving the Item XML content files. The default setting is sitexml.

In the code this appears as $xmlDirectory = "sitexml";. This variable can only be edited in the Output Code text area or using a text editor.

Item Administration

This is the name of the Item for use by site administration as a note pad. It does not appear in any menu structures and is only linked when the user is signed in. The default setting is Administration.

In the code this appears as $itemAdmin = "Administration";. This variable can only be edited in the Output Code text area or using a text editor.

Item Draft

This is the name of the Item used to save Draft content (ie work in progress). It does not appear in any menu structures. The default setting is Draft.

In the code this appears as $itemDraft = "Draft";. This variable can only be edited in the Output Code text area or using a text editor.

Auto Save Seconds

This is the duration in seconds between Auto Saves. If this variable is empty Auto Save is not used. The minimum value is 120. The default setting is 120.

In the code this appears as $autoSaveSeconds = "120";. This variable can only be edited in the Output Code text area or using a text editor.

Use Block

This value is used to identify character combinations that are not acceptable within Items. Items that include these character combinations cannot be saved. The default setting is empty.

In the code this appears as $useBlock = "";. This variable can only be edited in the Output Code text area or using a text editor.

Use Last Time

This is a time value used to force a Last Modified header time. The default setting is empty. If empty the Last Modified header time is derived from the server.

In the code this appears as $useLastTime = "";. This variable can only be edited in the Output Code text area or using a text editor.

Use Valid Tags

This is the HTML tags that are displayed at the top of the Content text area and are acceptable within Content. Each tag is separated by a comma ie , . The default setting is h2,h3,b,i,p,div,span,a,ol,ul,li,table,tr,td,img,script,QA. This variable is normally left as the default. If you add a tag it will be processed as a start and end tag ie <b> and </b>. If you do not require all the tags you can remove them.

In the code this appears as $useValidTags="h2,h3,b,i,p,div,span,a,ol,ul,li,table,tr,td,img,script,QA";. This variable can only be edited in the Output Code text area or using a text editor.

Color 1 Styles

This is the HTML elements and the CSS style that will be set to the Color 1 value. The default setting is 'body'=>'color',. This variable is normally left as the default.

In the code this appears as $color1Styles=array('body'=>'color',);. This variable can only be edited in the Output Code text area or using a text editor.

Color 2 Styles

This is the HTML elements and the CSS style that will be set to the Color 2 value. The default setting is 'body'=>'background-color','a'=>'background-color','div.menu li a:hover'=>'color','h1.title'=>'background-color','h2'=>'background-color','b'=>'background-color','.high'=>'background-color',. This variable is normally left as the default.

In the code this appears as $color2Styles=array('body'=>'background-color','a'=>'background-color','div.menu li a:hover'=>'color','h1.title'=>'background-color','h2'=>'background-color','b'=>'background-color','.high'=>'background-color',);. This variable can only be edited in the Output Code text area or using a text editor.

Color 3 Styles

This is the HTML elements and the CSS style that will be set to the Color 3 value. The default setting is 'a'=>'color','div.menu li a:hover'=>'background-color','h1.title'=>'color','h2'=>'color','h3'=>'color','b'=>'color',. This variable is normally left as the default.

In the code this appears as $color3Styles=array('a'=>'color','div.menu li a:hover'=>'background-color','h1.title'=>'color','h2'=>'color','h3'=>'color','b'=>'color',);. This variable can only be edited in the Output Code text area or using a text editor.

Color 4 Styles

This is the HTML elements and the CSS style that will be set to the Color 4 value. The default setting is 'div.menu li a'=>'border-color','h1.title'=>'border-bottom-color','h2'=>'border-bottom-color','h3'=>'border-bottom-color','div.rss'=>'border-color',. This variable is normally left as the default.

In the code this appears as $color4Styles=array('div.menu li a'=>'border-color','h1.title'=>'border-bottom-color','h2'=>'border-bottom-color','h3'=>'border-bottom-color','div.rss'=>'border-color',);. This variable can only be edited in the Output Code text area or using a text editor.

RSS Include Mark

This is the character combination that indicates the url following this mark should be formatted as a HTML display of an RSS feed. The default setting is rssurl=. This variable is normally left as the default.

In the code this appears as $rssIncludeMark='rssurl=';. This variable can only be edited in the Output Code text area or using a text editor.

RSS Channel Tags

These are the RSS feed Channel Tags used in the HTML display of an RSS feed. The default setting is 'title','link'. This variable is normally left as the default.

In the code this appears as $rssChannelTags = array('title','link');. This variable can only be edited in the Output Code text area or using a text editor.

RSS Item Tags

These are the RSS feed Item Tags used in the HTML display of an RSS feed. The default setting is 'title','link','description','pubDate'. This variable is normally left as the default.

In the code this appears as $rssItemTags = array('title','link','description','pubDate');. This variable can only be edited in the Output Code text area or using a text editor.

RSS Display HTML

If this is set as true and php on the server supports the html_entity_decode function any HTML code in a displayed RSS Feed will processed and displayed as HTML, if set as false it will be displayed as plain text. The default setting is false.

When $rssDisplayHtml is set as true encoding errors in an external RSS feed displayed within a page can impact on the validity of the page code and break the html. This may result in an incorrect page display.

In the code this appears as $rssDisplayHtml = "false";. This variable can only be edited in the Output Code text area or using a text editor.

Use Last Modified Header

This is the descriptor set in the HTTP Header for the last modified date. The default setting is Last-Modified: . This variable is normally left as the default.

In the code this appears as $useLastModHeader = "Last-Modified: ;". This variable can only be edited in the Output Code text area or using a text editor.

Use Password Key

This is the GET key used in the query string to for the passwrod value. The default setting is pw. This variable is normally left as the default.

In the code this appears as usePassWordKey = "pw";. This variable can only be edited in the Output Code text area or using a text editor.

Keyword Phrases

This is the number of words to be used within the phrases of the automatic Keyword generation. The default setting is 1,2,3;. This allows phrases of 1, 2 or 3 words in length.

In the code this appears as $kwPhrs=array(1,2,3);. This variable can only be edited in the Output Code text area or using a text editor.

Keyword Lengths

This is the minimum character length of words to be used within the corresponding Keyword Phrases of the automatic Keyword generation. The default setting is 6,5,5;. This allows words of 6 characters in 1 word Keyword Phrases, 5 characters in 2 word Keyword Phrases, and 5 characters in 3 word Keyword Phrases.

In the code this appears as $kwLens=array(6,5,5);. This variable can only be edited in the Output Code text area or using a text editor.

Keyword Numbers

This is the maximum number of phrases to be used within the corresponding Keyword Phrases of the automatic Keyword generation. The default setting is 5,3,3;. This allows up to 6 1 word Keyword Phrases, up to 3 2 word Keyword Phrases, and up to 3 3 word Keyword Phrases.

In the code this appears as $kwNums=array(5,3,3);. This variable can only be edited in the Output Code text area or using a text editor.

Keyword Excludes

This sets character combinations that will not be used as keywords. The default setting is empty.

In the code this appears as $kwExcs=array();. This variable can only be edited in the Output Code text area or using a text editor.

Alternate Variables

Alternate Variables allow you to set up a web page that uses the base Site Code file but provide alternative variables for some settings. This allows a wide range of flexibility in site structure and content while maintaining a consistent, easy to use and modify site wide style.

To setup a web page using Alternate Variables simply adjust the variable values as required in the text area below. You must set the $baseFile variable and this should be a Site Code file on your server ie index.php. Default values for all other variables are displayed in the text area. Copy and paste the contents of the text area to a text editor, save it as a file name with the php extension .php ie news.php and upload the file to your server. This file is your new web page.

Any Alternate Variable values must be an acceptable value for the variable they relate to.

Please refer to our Example Site Builder Software Applications and Techniques for additional information on this feature.

$baseFile is the Base File to be used for this web page. This file is Site Code that is used to provide the base formatting for the page ie index.php.

$altStaticItem is the alternative Use Static Item value and overrides $useStaticItem value in the Advanced Configuration Variables of the Base File if set. If empty it is ignored.
$altTitle is the alternative Use Title value and overrides $useTitle value in the Advanced Configuration Variables of the Base File if set. If empty it is ignored.
$altDesc is the alternative Use Description value and overrides $useDesc value in the Advanced Configuration Variables of the Base File if set. If empty it is ignored.
$altKw is the alternative Use Keywords value and overrides the $useKw value in the Advanced Configuration Variables of the Base File if set. If empty it is ignored.

$altItemMenuBaseFile this value sets the Base file to be used for the Item Menu. This is used to display an Item Menu based on the Item files of an alternative Base File. By default items associated with the Base File are displayed in the Item Menu. Set this value if you want the displayed Item Menu to show items that are associated with a different Base File. If empty it is ignored.
$altItemMenuXmlDirectory this value sets the Xml Directory to be used for the Item Menu. By default items associated with the Base File $xmlDirectory are displayed in the Item Menu. Set this value if you want the displayed Item Menu to show items that are associated with a different directory. If empty it is ignored.
$altItemMenuSortBy this value sets the Sort Order for the Item Menu. By default this order is set by the Item Sort By value in the Base File ($itemSortBy). Set this value if you want to change the Item Sort By order for the Item Menu. If empty it is ignored.
$altItemMenuReverseOrder this value sets the Sort Order for the Item Menu. By default this order is set by the Item Reverse Order value in the Base File ($itemReverseOrder). Set this value if you want to change the Item Reverse Order for the Item Menu. If empty it is ignored.

$altContentBaseFile this value sets the Base file to be used for the Content displayed on the web pages. This is used to display content based on the Item files of an alternative Base File. By default items associated with the Base File are displayed as content. Set this value if you want the displayed content items to be associated with a different Base File. If empty it is ignored.
$altContentXmlDirectory this value sets the Xml Directory to be used for the Content displayed on the web pages. By default items associated with the Base File are displayed as content. Set this value if you want the displayed Content items to be associated with a different directory. If empty it is ignored.
$altContentSortBy this value sets the Sort Order for the Content displayed on the web pages. By default this order is set by the Item Sort By value in the Base File ($itemSortBy). Set this value if you want to change the Item Sort By order for the Content. If empty it is ignored.
$altContentReverseOrder this value sets the Sort Order for the Content displayed on the web pages. By default this order is set by the Item Reverse Order value in the Base File ($itemReverseOrder). Set this value if you want to change the Item Reverse Order for the Content. If empty it is ignored.

$altItemMenu is the alternative ItemMenu value and overrides the $itemMenu value in the User Configuration Variables of the Base File if set.
$altItemMenuPreHtml is the alternative Item Menu Pre Html value and overrides the $itemMenuPreHtml value in the User Configuration Variables of the Base File if set as anything other than -.
$altItemMenuFirstFiles is the alternative Item Menu First Files value and overrides the $itemMenuFirstFiles value in the User Configuration Variables of the Base File if set as anything other than -.
$altItemMenuFirstTitles is the alternative Item Menu First Titles value and overrides the $itemMenuFirstTitles value in the User Configuration Variables of the Base File if set as anything other than -.
$altItemMenuLastFiles is the alternative Item Menu Last Files value and overrides the $itemMenuLastFiles value in the User Configuration Variables of the Base File if set as anything other than -.
$altItemMenuLastTitles is the alternative Item Menu Last Titles value and overrides the $itemMenuLastTitles value in the User Configuration Variables of the Base File if set as anything other than -.
$altItemMenuPostHtml is the alternative Item Menu Post Html value and overrides the $itemMenuPostHtml value in the User Configuration Variables of the Base File if set as anything other than -.
$altItemMenuExcludes is the alternative Item Menu Excludes value and overrides the $itemMenuExcludes value in the User Configuration Variables of the Base File if set as anything other than -.

$altItemDefault is the alternative Item Default value and overrides the $itemDefault value in the User Configuration Variables of the Base File if set as anything other than -.
$altHourOffset is the alternative Hour Offset value and overrides the $hourOffset value in the User Configuration Variables of the Base File if set as anything other than -.

$altPageMenu is the alternative Page Menu value and overrides the $pageMenu value in the User Configuration Variables of the Base File if set as true or false. If empty it is ignored.
$altItemPerPage is the alternative Items Per Page value and overrides the $itemPerPage value in the User Configuration Variables of the Base File if set. If empty it is ignored.
$altPagePerGroup is the alternative Pages Per Group value and overrides the $pagePerGroup value in the User Configuration Variables of the Base File if set. If empty it is ignored.

$altItemMenuRewriteExt is the alternative Item Menu Rewrite Extension value and overrides $itemMenuRewriteExt value in the in the Advanced Configuration Variables of the Base File if set as anything other than -.
$altHtmlFull is the alternative Html Full value and overrides the $htmlFull value in the User Configuration Variables of the Base File if set as true or false. If empty it is ignored.


Please refer to our Example Site Builder Software Applications and Techniques for additional information on these features.

Additional Information

This section includes a range of information relating to web site development. Please refer to our Example Site Builder Software Applications and Techniques for additional information.

URL Rewriting

URL Rewriting can be used on Apache web servers to convert dynamic urls to static urls. This can make urls cleaner for both users and search engines. As Site Code generated by Site Builder software creates a dynamic web site. URL Rewriting allows dynamic urls to be rewritten as static urls.

This is achieved using the sites .htaccess file. To rewrite urls to static .html pages instead of dynamic .php pages in the .htaccess file add the following lines:

Options +FollowSymLinks
RewriteEngine on
RewriteRule ^(.*)\.html$ /index.php?item=$1

This will result in the url Home.html actually loading the page index.php?item=Home. To users and search engines the page url is simple and static ie Home.html. If you are using an Item Menu you will also need to set the Item Menu Rewrite Extension as html. This will set the menu anchor links to the Item title with the Item Menu Rewrite Extension ie Home.html.

If the Site Code is not in the root site directory you will need to adjust the Rewrite Rule to:

RewriteRule ^(.*)\.html$ /sub/index.php?item=$1

where sub is the directory and index.php is the Site Code file.

Additional detail on URL Rewriting is available at http://httpd.apache.org/docs/2.0/misc/rewriteguide.html and http://www.webconfs.com/url-rewriting-tool.php

Please refer to our Example Site Builder Software Applications and Techniques for additional information on this feature.

Trouble Shooting

If the software displays a Browser Error notice:

Once you have current browser software with JavaScript enabled you will be able to access all software functions.

If php code displays in your browser when you Site Code is run on your server:

Make sure all your variable values are correct. This includes the case of letters, A is not the same as a.

If you Sign In but no Administration Links (New Item - Refresh - Draft - Sign Out - Administration) are displayed your browser may have cached the page and not be showing the current version. To reload a page and bypass the old cached page:

Requirements for Use

The software runs directly in your browser. Your browser must support JavaScript and the Document Object Model. Current browsers all support these features. If your browser does not support these features a Browser Error notification will be provided when you open the software.

The generated Site Code must run on your web server. To run Site Code on your server it must support the php scripting language. Most commercial web servers support php. For information on php and how to check if it is available on your server go to What is php?

Installation

Site Builder Software can be run directly from our server at http://www.softswot.com/sitebuilder/sitebuilder.html or you can Download Site Builder Software and run it on your computer. You will also need the files packaged in the download to run the Site Code on your server.

The latest version software is always available for download from softSWOT.com. If software is downloaded as a Self-Extracting SetUp file (.exe) when you run the .exe file it will extract and install the software files. If software is downloaded as a Compressed Zip file (.zip) it must be unzipped before you can save the software files. Trial Zip software is available free from Winzip or a simple freeware zip utility is available from JustZIPit. All software files should be installed in the same directory, this should be a new directory in which only the software files are placed. Once the software files are saved open the software title file (with a .html extension). This will open in your browser; JavaScript must be enabled; and follow the Instructions for Use.

This software does not access or alter your system or system files in any way. To uninstall you can simply delete the directory and included software files created and saved when you installed the software. Alternatively if a Self-Extracting SetUp file was used for installation you will be able to remove the software using Uninstall from the shortcut menu.

Conditions of Use

The specific suitability of this software must be independently assessed. Software is provided as is, use is entirely at the users risk, and use acknowledges that softSWOT and all associated parties are held harmless from any claims or losses relating to software provided.

Software Support and Contact Details

For items not addressed here please visit softSWOT.com where you can access our Question and Answer Items. In our Question and Answer Items we post responses to a range of topics related to this software. It provides a growing knowledge base and allows you to benefit from the experience of others, if you have read all of the Help file and still have a question this is a good place to start. If after completely reading and following the Help file, and reviewing our Question and Answer Items your question is unanswered please Contact Us.

Web Site: www.softswot.com

Full contact details are provided at Contact Us.

softSWOT is a member of the Bizpep Group
ABN: 24 312 166 103

Regards
David Morcom
www.softswot.com