[project/panels.git] / README.txt

The panels module is the ideological son, successor to and almost complete \r
replacement for the dashboard module. This module allows you to create pages \r
that are divided into areas of the page. Where the dashboard module only gave \r
four areas--top, bottom, left and right--this one is a completely flexible \r
system that includes a couple of 2 column and 3 column layouts by default, but \r
is also highly extensible and other layouts can be plugged in with a little HTML \r
and CSS knowledge, with just enough PHP knowledge to be able to edit an include \r
file without breaking it.\r
\r
Perhaps most importantly, unlike the dashboard module it requires no fiddling \r
with PHP code to include the things you want; the interface lets you add blocks, \r
nodes and custom content just by selecting and clicking. \r
\r
If you want to override the CSS of a panel, the easiest way is to just copy\r
the CSS into your theme directory and tweak; panels will look there before\r
including the CSS from the module, and if it exists, will not include the\r
module's CSS. If you want to just change a tiny bit but keep the basic\r
structure, just add your changes to your style.css instead.\r
\r
If you're having problems with IE and your panels falling below your sidebars,\r
try setting the width of the main panel area (example, .panel-2col-stacked) to\r
98%.\r
\r
If you need to check if the current page is a panels page in your theme\r
(for example if you want to hide some existing sidebars in your theme on\r
these pages) then you can use the panels_is_panels_page() function.
Commit	Line	Data
5adb76b5 EM	1	The panels module is the ideological son, successor to and almost complete \r
	2	replacement for the dashboard module. This module allows you to create pages \r
	3	that are divided into areas of the page. Where the dashboard module only gave \r
	4	four areas--top, bottom, left and right--this one is a completely flexible \r
	5	system that includes a couple of 2 column and 3 column layouts by default, but \r
	6	is also highly extensible and other layouts can be plugged in with a little HTML \r
	7	and CSS knowledge, with just enough PHP knowledge to be able to edit an include \r
	8	file without breaking it.\r
	9	\r
	10	Perhaps most importantly, unlike the dashboard module it requires no fiddling \r
	11	with PHP code to include the things you want; the interface lets you add blocks, \r
aee333f1 EM	12	nodes and custom content just by selecting and clicking. \r
	13	\r
	14	If you want to override the CSS of a panel, the easiest way is to just copy\r
	15	the CSS into your theme directory and tweak; panels will look there before\r
	16	including the CSS from the module, and if it exists, will not include the\r
	17	module's CSS. If you want to just change a tiny bit but keep the basic\r
f82416ed EM	18	structure, just add your changes to your style.css instead.\r
	19	\r
	20	If you're having problems with IE and your panels falling below your sidebars,\r
	21	try setting the width of the main panel area (example, .panel-2col-stacked) to\r
	22	98%.\r
c370d4be EM	23	\r
	24	If you need to check if the current page is a panels page in your theme\r
	25	(for example if you want to hide some existing sidebars in your theme on\r
	26	these pages) then you can use the panels_is_panels_page() function.