Re: [Phpwebsite-developers] Fallout Selectors

[Matthew M. <ma...@tu...>]

On Mon, 2006-02-27 at 23:00 -0700, Greg Morgan wrote:
> -----BEGIN PGP SIGNED MESSAGE-----
> Hash: SHA1
> 
> Through the magix of find; grep; vim regex tricks; and sort -u; a list
> of fallout default theme selectors has been created.
> http://phpwebsite-comm.sourceforge.net/wiki/index.php?title=En_default

First of all, nice work. This list will let us decide of what the core
set of styles consist.

Here is a quick definition list.

align-(center, left, right) : a shortcut class to prevent inline styles
and align="left"

bgcolor1-3 : I figured these would be the replacements for bg_light and
such. Setting these three background colors set the colors for the site

bigger & smaller : makes the font bigger and smaller. again an attempt
at preventing inline styles

box, box-title, box-content : since box template files have been
removed, I use these to style the content containers.

module styles : specific styles associated with a module. These could
use a review.

img.float-left/right : again, to prevent inline styles

no-bullet : used in a ul to prevent bullets

phpws_form : id of any generic form made with the form class

spoiler : used in bb code. Hides text until moused over. Used in
comments

Ask about any others.

By the way, when I wrote the alternate style sheet blue, I was testing
it against the default. As a result, once I was sure it worked, I
stopped changing over the values. That is why blue still has some brown
in it.

> Moreover, what shall I make out of the theme.ini file?
> 
> [theme_variables]
> 0 = LAYOUT_HEADER
> 1 = LAYOUT_FOOTER
> 2 = BOTTOM
> 3 = USERS_LOGIN_BOX
> 4 = NOTES_REMINDER
> 5 = CATEGORIES_ADMIN_MENU
> 6 = SEARCH_SEARCH_BOX

These values tell Layout what extra content sections you have in your
theme. 
Each theme MUST have BODY and DEFAULT. Beyond that, you can create a
content section just by adding it to the numeric list. If these are not
put in, you cannot move content around the page and content will not
anchor properly.

BOTTOM is just a generic content area. The others are module specific.
In phpwebsite 0.10.x you use the $GLOBALS['content_var'] variable. In
Fallout, you just call a Layout function:
Layout::add('Some content');

If called like so, the content is appended to the BODY area. If however
you do this:
Layout::add('Some content', 'search', 'search_box');

it lets Layout know you want to have a movable element.

The theme variables that are prefixes by module names are anchors. The
first time the above content was created, layout checks to see if it has
an anchor, if it doesn't, it checks the theme.ini file for a module_name
+ content variable name. If it finds that variable, it places the
content in that space. If it doesn't, it plops it into the DEFAULT theme
variable.

This allows people to choose a theme and just have it work without
having to move boxes afterward. It also gives the theme developer more
room to style certain components (the menu for example).


> [persistant_style_sheet]
> file = style.css
> 
> [default_style_sheet]
> file = default.css
> title = Default Delite
> 
> [alternate_style_sheet_1]
> file = blue.css
> title = Blue

A persistent style sheet is always loaded. (yes I realize I misspelled
it now)
The default style sheet is then loaded.
The alternate style sheets are loaded should the user want a different
view. Firefox allows you to do this but if you want the change to
"stick" you may have to download an extension.

For now, I put positioning, font sizes, padding widths, etc. in the
persistent style sheet. Color choices go into the default and alternate.
You are not required to use this format, you could just use ONE style
sheet if you wish. Default uses alternates as an example.

Thanks Greg,
Matt

-- 
Matthew McNaney
Electronic Student Services
Appalachian State University
http://phpwebsite.appstate.edu