Working with Pages
Creating a new web page in BoltWire is pretty easy. So is editing, renaming, copying, and deleting one. Each of these processes are called actions, and BoltWire comes with about 20 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 of each page: login, register, search, and print. Before you can create or edit a page, you must login. Once you login, you will have access to more actions. If you login as an editor or admin, you will have access to even more. Later, you can create member groups and customize permissions for them, or even for specific members, for any page or action you want. For details, see the tutorials on member management and security. For now, just login to your site as the superadmin.
Below is a list of several default actions with a brief explanation of what each one does. For a complete list of the default actions that come with BoltWire, click here. To perform an action, just click the appropriate link from the list at the top of the page.
|View||This action switches from another action (like edit or rename) back to the normal viewing 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 change it. Backups (stamps) are made of each change so you can undo them.|
|Copy||This allows you to make a copy of a page and save it to a new name. You can modify the contents first, and the original is left unchanged.|
|Rename||This action allows you to rename a page. A backup (stamp) is made of the page at the old location.|
|Delete||This allows you to delete a page. A backup (stamp) is made first, which you can restore at a later time.|
|Undo||This command checks for backups (stamps) of a page and allows you to restore the content to any available prior version.|
|This action produces a simplified page display focused on the content of the page, specially formatted for printing.|
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, so there is no difference between page Some.Page and some.page. This makes 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 using CleanURL's), you will see a path to your site, 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. If an action is being performed on a page, BoltWire will add some additional information to the end of the URL, like: &action=edit. Other parameters may be added to a URL in certain situations as well.
Because we often would rather have a page titled "Some Page" and not some.page, 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. The title for this page has been set to "Working With Pages", and it appears wherever the page title is called for. Very convenient!
It is a good idea to group similar pages together. This allows you to control settings for entire groups of pages all at once. Suppose for example you created pages public.one, public.two, and public.three, then private.one, private.two, and private.three. You could very easily set view permissions to the public pages for any visitor, and limit viewing of the private pages to a specific group of logged in members.
In addition to view permissions, you can assign edit authorizations to page groups, customize their headers, footers, and side menus, create specialized actions, enable various plugins, and set various configuration options as well. Learning to use page groups effectively can make web administration much simpler, and accomplish some amazing effects. Before getting too far in your site creation, you should sketch out a simple hierarchy of how you will want to organize your pages. Click here, for more information on page hierarchies.