Ready to begin building your website? Here are a few things you should know that will help you get started.
Creating a new web page in BoltWire is pretty easy. So is editing one, renaming one, and deleting one. Each of these processes are called actions, and BoltWire comes with nearly 30 actions pre-installed --enough to keep you busy for awhile. Later you can learn how to customize actions to work in different ways, or create entirely new ones. This document just looks at some of the default actions.
When you first view a newly created site, you will see four actions along the top and bottom of each page: login, register, search, and print. Before you can edit a page, you must login. If you login as a BOLTadmin, you will have access to every action, on any page. If you login as a regular member, you will have access to only certain actions, on certain pages. Later, you can create various member groups and customize permissions for groups, or even specific members, however you wish. For more information, see the tutorials on member management and security. For now just login as a BOLTadmin.
Below is a list of some of the common default actions with a brief explanation of what each one does. To perform an action, just click the appropriate link from the list of actions along the top and bottom of the page:
|View||This action switches from an action mode (like edit or rename) back to normal view mode, without performing that action.|
|Create||This action is used to create a new page. You will get a warning message if you try to create a page that already exists.|
|Edit||This loads the contents of the current page into an edit window, so you can make changes to it.|
|Copy||This loads the contents of the current page, and then allows you to save it to a new name. You can change the contents before copying them, but the original page will not be changed in any way.|
|Rename||This allows you to rename a page, but does not allow you to change any content.|
|Delete||This action allows you to delete a page. By default, a backup (stamp) is made of deleted pages, you can restore at a later time. To restore an earlier version of a page, go to the history action for that page.|
|This action produces a simplified web page focused on the content of the page, specially formatted for printing.|
For a complete list of all the actions available to you, click the "site" link in your action bar. It will generate a table of all the current actions on your system, as well as other important system pages.
Before creating pages, there are few things you should know about BoltWire page names. First, page names can only contain letters, numbers, hyphens, underscores, and dots. Second, all page names are automatically converted to lower case (unless WikiWords are enabled), so there is no difference between page SomePage and somepage. This helps to make links in BoltWire case insensitive, and cuts down on user errors.
You can see the current page name by looking at the URL in your browser address bar. Normally (unless you are using CleanURL's), you will see a path to your field, followed by index.php and then a question mark. Immediately after you should see p=some.page. The "p" stands for page. What follows is the name of the page. This page, for example, is named docs.start.pages.
Note: if an action is being performed on a page, BoltWire will add some additional characters to the end of the URL, of the form: &action=whatever. You can call an action on a page directly, by simply adding the appropriate request to the URL of some page. Note also, that there may be other additional parameters added to a URL as well in certain situations.
Another thing to know is that page names are fully hierarchical. For a more complete explanation of what this means, read the page on hierarchical groups. But in short, it means you can create pages within pages. So for example:
is actually a page called dog, within page canine, which is within animal, which is within kingdom. This is especially important, because attributes assigned to one page, are passed down to all the pages within them. So by changing one setting in kingdom.animal, and another in kingdom.plant, you can instantly change all the dog, cat, grass, and tree pages to the appropriate settings of their hierarchies.
Some of the settings that can be passed down include view/edit permissions, custom skins and stylesheets, page headers, footers, and side menus, various plugins, and many other configuration options. Learning to use hierarchies effectively can thus make web administration dramatically simpler, and accomplish some surprizing effects. For example, you could create a members only area by simply putting all of your protected pages within a "member" page, and then view protecting them all with one setting. For now however, it is enough to know similar pages should be grouped together and given an appropriate hierarchical name. You may wish to sketch out a simple tree of how your pages should be organized.
Because we often would rather have a page titled "Some Page" and not "somepage", BoltWire has a special title action which allows you to assign a title to a page. If no title is set, BoltWire will take the last part of the page name for its title, and capitalize it. So the title of kingdom.animal.canine.dog is simply "Dog". Using the title action, however, I can assign the page a new title, such as "My Dog Spot!" and BoltWire will use that wherever the page title is called for. Very convenient!
Using good page names and taking advantage of BoltWire's title action will help get your website off to a good start.