themes/multiflex3/README.txt

// $Id: README.txt,v 1.2.2.4 2009/05/11 07:07:14 hswong3i Exp $

ABOUT MULTIFLEX-3
----------------------

This is a re-implementation of the Multiflex-3 theme by Gerhard. This is
a tableless, multi-column, fluid width layout. Parts of the design are
ported from Contented7, Internet Services and Interactive Media theme.

Official MULTIFLEX-3 project page:
  http://www.1234.info/webtemplates/multiflex3/

Drupal Multiflex-3 project page:
  http://drupal.org/project/multiflex3/
  http://pantarei.com.hk/projects/multiflex3/

Sponsored by:
  http://pantarei.com.hk/


HOWTO CUSTOMIZE THIS THEME?
----------------------

For theme customization usually you will need to change the style.css.
By the way this traditional method is not too flexible.

This theme provide a hook called as custom.css. The custom.css will always
override default style.css setting, and will not be covered during version
upgrade. Benefit of using this hook including:

  1. Your customization will NOT get mixed with original theme style.
  2. Your customization will NOT be override during theme upgrade.

This theme also provide some example for customization within
custom.example.css, divided into section by section. You can copy-and-paste
them to your custom.css and feel free to change it.


HOW THE MISSION HACK FUNCTION?
----------------------

By default, mission statement is protected by filter_xss_admin() so no
PHP script is allowed. On the other hand, all tags that can be used inside
an HTML body is allowed.

This theme provide a fancy hack so PHP script will able to execute if
mission statement starting with "<?php", or else will preform as default
style.

One example usage is combine with adsense module so only display a
skyscraper (120x600) at top page; another example is combine with banner
module so you will have a benner rotation as mission statement; or even
just execute a simple PHP code snippet as welcome message when user login.


HOW THE CASCADE PRIMARY LINKS HACK FUNCTION?
----------------------

The cascade primary links is one of the most spotlight feature of original
Multiflex-3 theme design. This Drupal re-implementation also come with a
special hack for it. In order to activate it, please follow this procedure:

  1. Define your primary links with cascaded items.
  2. Set the parent item as "Expanded".

There is also some limitation of this implementation:

  1. Don't support IE6. Since IE6 need a special hack with "table", which
     will be unnecessary complicated the implementation. Moreover, some
     special CSS hack is required, too.
  2. Only support maximum 4 level of menus; others will looks buggy.

It is completely independent with original Drupal's primary/secondary links
handling. Set the primary and secondary links as same source will just
function as other typical Drupal themes.


ABOUT RTL SUPPORT (>=6.x)
----------------------

This theme is RTL supported, and fully tested with Acid2 compatible
browsers, e.g. FireFox3, Opera9.2 and Safari3. However, other browser
such as FireFox2 and Internet Explorer 6/7 may looks buggy.

As the implementation is validate with XHTML and CSS2 coding standard,
I am not going to provide browser-specific hack, for both LTR and RTL.

For more information about Acid2:
  http://en.wikipedia.org/wiki/Acid2

To test your browser with Acid2:
  http://www.webstandards.org/files/acid2/test.html


LIST OF MAINTAINERS
----------------------

PROJECT OWNER
M: Edison Wong <hswong3i@gmail.com>
S: maintained
W: http://edin.no-ip.com/
1	// $Id: README.txt,v 1.2.2.4 2009/05/11 07:07:14 hswong3i Exp $
2
3	ABOUT MULTIFLEX-3
4	----------------------
5
6	This is a re-implementation of the Multiflex-3 theme by Gerhard. This is
7	a tableless, multi-column, fluid width layout. Parts of the design are
8	ported from Contented7, Internet Services and Interactive Media theme.
9
10	Official MULTIFLEX-3 project page:
11	http://www.1234.info/webtemplates/multiflex3/
12
13	Drupal Multiflex-3 project page:
14	http://drupal.org/project/multiflex3/
15	http://pantarei.com.hk/projects/multiflex3/
16
17	Sponsored by:
18	http://pantarei.com.hk/
19
20
21	HOWTO CUSTOMIZE THIS THEME?
22	----------------------
23
24	For theme customization usually you will need to change the style.css.
25	By the way this traditional method is not too flexible.
26
27	This theme provide a hook called as custom.css. The custom.css will always
28	override default style.css setting, and will not be covered during version
29	upgrade. Benefit of using this hook including:
30
31	1. Your customization will NOT get mixed with original theme style.
32	2. Your customization will NOT be override during theme upgrade.
33
34	This theme also provide some example for customization within
35	custom.example.css, divided into section by section. You can copy-and-paste
36	them to your custom.css and feel free to change it.
37
38
39	HOW THE MISSION HACK FUNCTION?
40	----------------------
41
42	By default, mission statement is protected by filter_xss_admin() so no
43	PHP script is allowed. On the other hand, all tags that can be used inside
44	an HTML body is allowed.
45
46	This theme provide a fancy hack so PHP script will able to execute if
47	mission statement starting with "<?php", or else will preform as default
48	style.
49
50	One example usage is combine with adsense module so only display a
51	skyscraper (120x600) at top page; another example is combine with banner
52	module so you will have a benner rotation as mission statement; or even
53	just execute a simple PHP code snippet as welcome message when user login.
54
55
56	HOW THE CASCADE PRIMARY LINKS HACK FUNCTION?
57	----------------------
58
59	The cascade primary links is one of the most spotlight feature of original
60	Multiflex-3 theme design. This Drupal re-implementation also come with a
61	special hack for it. In order to activate it, please follow this procedure:
62
63	1. Define your primary links with cascaded items.
64	2. Set the parent item as "Expanded".
65
66	There is also some limitation of this implementation:
67
68	1. Don't support IE6. Since IE6 need a special hack with "table", which
69	will be unnecessary complicated the implementation. Moreover, some
70	special CSS hack is required, too.
71	2. Only support maximum 4 level of menus; others will looks buggy.
72
73	It is completely independent with original Drupal's primary/secondary links
74	handling. Set the primary and secondary links as same source will just
75	function as other typical Drupal themes.
76
77
78	ABOUT RTL SUPPORT (>=6.x)
79	----------------------
80
81	This theme is RTL supported, and fully tested with Acid2 compatible
82	browsers, e.g. FireFox3, Opera9.2 and Safari3. However, other browser
83	such as FireFox2 and Internet Explorer 6/7 may looks buggy.
84
85	As the implementation is validate with XHTML and CSS2 coding standard,
86	I am not going to provide browser-specific hack, for both LTR and RTL.
87
88	For more information about Acid2:
89	http://en.wikipedia.org/wiki/Acid2
90
91	To test your browser with Acid2:
92	http://www.webstandards.org/files/acid2/test.html
93
94
95	LIST OF MAINTAINERS
96	----------------------
97
98	PROJECT OWNER
99	M: Edison Wong <hswong3i@gmail.com>
100	S: maintained
101	W: http://edin.no-ip.com/