This is called a {CONTAINER}
This is called an <!--INCLUDE-->
It's not recommended to rename dragonfly core containers or includes because it can break your theme.

--------------------------------------
General Themeing:
--------------------------------------
{S_LOGO}
Will display you site's logo you chose in admin>main settings

{G_LEFTIMAGE} and {G_LEFTIMAGE}
The main toggle content (+ or -) images that close an entire side

{S_CAN_ADMIN}
Checks for admin privaleges and prevents content being displayed to those without them.

{S_SITENAME}
Simple way of displaying the site name you've chosen in admin>main settings. Often used in conjunction with {S_LOGO} so when people click on the logo they are taken to your home page or is used as an alt="{S_SITENAME}" tag.

{U_MY_ACCOUNT}
If a user is logged it in will take them to my account, if not it will prompt them to register.

{U_ADMININDEX}
Will take an admin back to the main admin panel.

{U_MAININDEX}
Will take a user back to the main index page.
Isn't this the same thing as S_HOME?

{S_HOME}
Your sites homepage as you've set in admin>modules

{THEME_PATH} = www.yourdomain.com/the...yourtheme/
This does not work in theme.php. It only works within the /template/ folder.

{S_WELCOME}
Used in some themes for welcome messages such as: Welcome DJDevon3
Use this in your theme.php
'S_WELCOME' => is_user() ? 'Welcome '.$userinfo['username'] : 'Welcome '._ANONYMOUS,

{S_NOWTIME}
Again, only used in some themes to display the current time.
In theme.php use
S_NOWTIME' => $date,
You will also have to define the variable $date as
$date = ''.date('D F j, Y, g:i a T');

--------------------------------------
Theme Templating Includes:
--------------------------------------
<!-- IF S_ADMIN_MENU -->
Displays the dhtml admin menu if in administration panel and you have it turned on in admin>misc

<!-- IF S_IS_USER -->
This will allow you to hardcode things visible only to registered users such as login windows and welcome messages.

<!-- IF S_IS_ADMIN -->
This will allow you to hardcode things visible only to admins such as ::Administration:: in the header navigation menu.

<!-- IF PUBLIC_HEADER -->
Sets off what is not to be displayed as a header when in admin mode.

--------------------------------------
Sideblock Themeing:
--------------------------------------
{S_TITLE}
Displays the title of a block that you choose in admin>blocks

{S_CONTENT}
The database content of a block

{IMPORTANT_MESSAGE}
Only here to notify you of when you go in or out of maintenence mode.
This almost always has red bold text that says "Warning: You are in Maintenence Mode".

{messageblock.S_TITLE}
Anything with messageblock it associated with the admin messages feature found in admin>messages.

--------------------------------------
Toggle Content Explained:
--------------------------------------
<!-- IF S_LEFTBLOCKS -->
<td class="mainside" id="pe600" {B_L_VISIBLE}>
mainside is generally a class used that travels the entire width and height of both side blocks. it is the "main" "sideblock" class.

<!-- BEGIN leftblock -->
<img align="right" alt="Toggle Content" title="Toggle Content" id="pic{leftblock.S_BID}" src="{leftblock.S_IMAGE}" onclick="blockswitch('{leftblock.S_BID}');" style="cursor:pointer" />
This is usually the + or - image that collapses the block using the leftblock.S_IMAGE source set in theme.php.

<div id="pe{leftblock.S_BID}"{leftblock.S_VISIBLE}>
Sets the beginning of the area to be collapsed.

</div>
Sets the end of the area to be collapsed.

--------------------------------------
Footer Themeing:
--------------------------------------
{S_FOOTER}
Displays what you have set in admin>main settings>footer

{S_DEBUG_SQL}
Displays CMS error messages set in admin>main settings>debug

{S_DEBUG_PHP}
Displays PHP error messages set in admin>main settings>debug

Very nice guide, perhaps a good entry for the wiki?

Yes, it is very nice.

awesine, i'll keep hacking my way at some others and give you my imput as well

great post.

what about setting a unique TITLE for each "site" that shares a common dragonfly database?

maybe there can be an area of these Fora that discusses the shared database methods? i'm sure i can't be the only user doing this.

cheers,

duffbeer

heh, this would be a great way to do the main menu links like i was asking. if the code was like this:

i would add to theme.php:

Code::

'S_MAIN_MENU_INDEX' => $mainmenuindex,

then somewhere in theme.php i would define that $mainmenuindex:

Code::

$mainmenuindex = /* links */ /* in here i could just determine the main menu links via HTML and make it easy on myself AND have to change only one file instead of going into the theme */

if that's the case then it should rock harder than before

ok. i made a pretty big list here and i included some .php files even tho they aren't needed. but i uncluded them because i think they are relevant. it's a .rtf file so i'll include that in this as well but i will post it on it's own as well here:

Quote::

this file is a description of as many of the tags that i could find in the .php files associated with dragonfly and thier associated themes. some might not have been found and some might plum not be in here. correct me if i'm wrong then. not gonna do forums yet until i actually theme those myself so that's gonna take some time as well. then i'll document that as well and put it up on DF too. Files: these are the main files that you'll be theming and descriptions on what part of the site that they theme. ../ confrim_body.html: this is the confirmation screen. it's the general one that asks you a question that has a Yes No answer. like when you want to remove/uninstall/change permissions on a module header.html: the header determines that gaudy header that your're probably going to have. it also determines the size of the site and the left and center top block theming footer.html: this file determines wqhat the bottom of the site is gonna look like. it also determines the size of the bottom as well as the look and size of the right and center bottom blocks block.html: i don't understand why this one is here in the first place. once i know that then i can make this alot more legit sounding memberlist.html: what it looks like when you goto the memberlist section of the site if you have that activated theme/admin admin.html: i'm not totally sure what this does yet. i think it handles all the graphical admin menu stuff and some or the other admin stuff index_body.html: nothing here. there is no need for this file. there is only one HTML thing in there. i bet if this whole file is deleted nothing big will happen groups.html: when you go admin crazy on grups this themes that. theme/news article.html: this is what the actual article looks like. so whatever you do here is what it looks like AFTER they click the read more button index.html: this templates the news that you see if the news is on the main page. comments.html: this themes the comments of the news section of the site. once people are registered they come here and add comments. that's the part that this file templates ------------------------------------------------------------ simple prefixes S_: Site association U_: User association G_: dunno B_L_: dunno B_R_: dunno L_: dunno complicated prefixes memberrow: ? bottomblock: ? messageblock: ? rightblock: ? left block: ? centerblock: ? menucat: ? newstopic: ? newsempty ? ------------------------------------------------------------ Misc. <!-- END newsempty -->: ? <!-- IF B_PAGINATION -->: ? <!-- IF PAGINATION_PREV -->: ? <!-- BEGIN pagination -->: ? <!-- IF pagination.URL -->: ? <!-- END pagination -->: ? <!-- IF PAGINATION_NEXT -->: ? <!-- BEGIN newscat -->: ? <!-- IF newstopic.S_NOTES -->: ? <!-- ELSEIF -->: ? <!-- ENDIF -->: ? ------------------------------------------------------------ root folder confrim_body.html S_HIDDEN_FIELDS: dunno MESSAGE_TITLE: dunno MESSAGE_TEXT: dunno L_YES: yes button L_NO: no button header.html S_HEADER_TAGS: something to do with the header leftblock.S_TITLE: title for the left block leftblock.S_CONTENT: the content of what's in a left block IMPORTANT_MESSAGE: this is the maintenence mose message. in red messageblock.S_TITLE: the title of the admin message. the default is the welcome to DragonFLY site thingy when you first install messageblock.S_EDIT: the message body i'm guessing centerblock.S_TITLE: when you set a block to the center this is where the title goes. bitches centerblock.S_CONTENT: the content of the center block NOTES: from what i've noticed here is that the header contains alot of information. the size of the site (header and .maintable. it also holds the message content and left and center block template system. it's kind of convuluted with the message and blocks so it's a little difficult to understand why it's there. footer.html bottomblock.S_TITLE: the title of the bottom center block bottomblock.S_CONTENT: the content of the bottom center block rightblock.S_TITLE: the title of the right block rightblock.S_CONTENT: the content of the right block S_FOOTER: the actual footer S_DEBUG_SQL: the MySQL debug information if it's set to show S_DEBUG_PHP: the PHP debug information if it's set to show NOTES: i don't understand why the right block is here in the footer and not in the header as well. blck.html block.S_TITLE: the title of the block block.S_CONTENT: the content of the block NOTES: i don't understand why the block template is here if there are right and left block templates set in the header footer. this needs clarification memberlist.html L_SELECT_SORT_METHOD:  self explainatory S_MODE_SELECT: dunno L_ORDER: dunno S_ORDER_SELECT: dunno L_PM: PM user L_USERNAME: Username L_EMAIL: Email L_FROM: addy L_JOINED: join date L_POSTS: post count L_WEBSITE: thier website memberrow.ROW_NUMBER: not sure memberrow.PM_IMG: private message image memberrow.USERNAME: username link memberrow.EMAIL_IMG: email image memberrow.FROM: addy memberrow.JOINED: join date memberrow.POSTS: post count memberrow.WWW_IMG: website image PAGE_NUMBER: page number or something PAGINATION: bread crumbs i'm guessing ------------------------------------------------------------ theme/admin admin.html menucat.TITLE: dunno menucat.menuitem.IMAGE: the image of graphic admin menucat.menuitem.TITLE: the title of graphic admin menucat.menuitem.U_OPTION: the link index_body.html nuffin' groups.html far too much crap for tonight ------------------------------------------------------------ theme/news article.html newstopic.S_TITLE: S_STORY: the story title? S_STORYEXT: the story text? S_NOTE: notes S_NOTES: more notes? S_POSTEDBY: 'Posted by' text S_INFORMANT: the author link S_ON: date S_TIME: time posted S_READS: how many reads S_ADMIN: if you are still logged in as admin you see this here S_ASSOTOPIC: assoicated topic (if you care about this stuff S_ASSOTOPICS: ditto, it's the link NOTES: this is what the actual article looks like. so whatever you do here is what it looks like AFTER they click the read more button index.html newsempty.S_SITENAME: ? newsempty.S_NOTOPIC: ? newsempty.S_GONEWS: ? newsempty.S_SELECT: ? newscat.S_SITENAME: ? newscat.S_TOPIC_T: ? newscat.S_SEARCHON: ? newscat.S_GOHOME: ? newscat.S_SELECT: ? newstopic.S_TITLE: news title newstopic.S_STORY: i think this is what is supposed to be snippet that shows on the main page newstopic.S_NOTE: notes newstopic.S_NOTES: more notes newstopic.S_MORELINK: read more newstopic.S_POSTEDBY: 'Posted by' Text newstopic.S_INFORMANT: the authour and thier link newstopic.S_ON: post date newstopic.S_TIME: post time newstopic.S_READS: read count pagination.PAGE: back a page (bread crumb) pagination.PAGE: foward a page (bread crumb) NOTES: i don't know what all these mean. i'll need help filing these out comments.html S_NOCOMMENTS: i think this is to say that no commets are allowed on this page S_TITLE: the title of the comment S_USER: the user that is posting S_COUNT: which post is this? S_COMMENTS: ? S_THRESHOLD: ? S_SELTHOLD: ? S_SELMODE: ? S_SELORDER: ? F_NEWSHIDE: ? S_COMMWARN: ? comment.S_READCOMM: comment.S_BYNAME: comment.S_ON: comment.S_DATE: comment.S_BY: comment.S_NAME: comment.S_ON: comment.S_DATE: comment.S_IP: comment.S_BYNAME: comment.S_ON: comment.S_DATE: comment.S_IP: comment.S_SCORE: comment.I_SCORE: comment.S_REASON: comment.S_COMMENT: comment.S_COMMENTEXT: comment.S_REPLY: comment.S_PARENT: comment.S_MODERATE: comment.S_DELETE: F_MODHIDE: NOTES: this template handles what the comments in the news are supposed to look like. ------------------------------------------------------------ ...::: .php files :::... Footer.php CSS_FILE: this is your css file. i don't understand why it's even here. it's so much easier to just say the name of the file. this is put in at the top of the file to determine the .css file. as so: type="text/css" href="{THEME_PATH}/style/{CSS_FILE}.css" this belongs in any html theme file taht you plan to use your style sheet in. probably for good measuer i would say put it in there anyway. themeheader() PUBLIC_HEADER: your admin pages to the best of my knowladge B_L_VISIBLE: dunno B_L_HIDDEN: dunno G_LEFTIMAGE: Toggle content images for sideblocks of an entire side (closes/opens an entire side) header.html G_RIGHTIMAGE: Toggle content images for sideblocks of an entire side (closes/opens an entire side header.html S_IS_ADMIN: dunno S_CAN_ADMIN: dunno S_IS_USER: dunno S_LOGO: i'm assuming your site logo image S_SITENAME: this is the site name and where it's supposed to show on the theme. S_HOME: dunno S_DOWNLOADS: dunno S_FORUMS: dunno S_MY_ACCOUNT: dunno S_ADMIN: dunno S_BANNER: dunno U_MAININDEX: dunno U_DOWNLOADS: dunno U_FORUMS: dunno U_MY_ACCOUNT: dunno U_ADMININDEX: dunno WELCOME: saying hello to the user. put this int he useringo area S_NOWTIME: the time. uses the date() PHP function themefooter() B_R_VISIBLE: B_R_HIDDEN: S_FOOTER: the message at the footer themesidebox() S_TITLE: the title of the block S_CONTENT: the actual content of that block S_BID: the block ID S_VISIBLE: is it set to visible? S_HIDDEN: is it hidden (i dunno the difference) S_IMAGE: the collapse uncollapge images associated with blocks in general Header.php head() IMPORTANT_MESSAGE: maintenence mode message S_TEXTDIR: dunno S_LANGCODE: the site language code. english, etc S_HEADER_TAGS: dunno S_LEFTBLOCKS: not too sure about S_RIGHTBLOCKS:not too sure about I18N: the excryption type as far as i'm concerened PAGE_TITLE: the page title S_ADMIN_MENU: which admin menu item? exactly Footer.php footmsg() S_DEBUG_PHP: PHP debug stuff. if it's set S_DEBUG_SQL: MySQL debug stuff. if it's set

index_body is in template/admin

when in any admin module it's what is responsible for showing "Main Menu" and "Log Out" buttons.

i could easily describe about 99% of all theme functions. it would be chaotic to just list them all though. something like this needs to go in wiki or some type of tracking project because the way theme'ing is done changes with every release of dragonfly.

well that's what i wanted to do. with this and my modcule creation FAQ but i wanted to get it completed before i submit it to the Devs to put in the Wiki

did you ever submit this to the wiki. if not please go ahead and include my stuff in it. i'm too busy to keep something this large updated.

oh. i'll add it to what i have so far then submit it. give me a few hours

Where are these terms defined? I want to change S_MY_ACCOUNT to link to the login page rather than the register page when the user is not logged in. Is this possible?

yep. it is.

S_My_ACCOUNT should be in the YOUR_ACCT module. defined in the index.php. i'm just taking a stab in the dark at where it is but i bet you that it's there.

take that tag and put it wherever you want. you might need to do the if check around it but i doubt it

[edit] whoops i was wrong. it's in the themeheader() in theme.php

you don't need the XHTML if checks (i think that's what they are) around it.

here is the code for it so you can see what it looks like:

Code::

$cpgtpl->assign_vars(array( 'S_FORUMS' => _ForumsLANG, 'S_MY_ACCOUNT' => is_user() ? _Your_AccountLANG : _BREG, ' ));

it's on line 69. rock out dude

modules/your_account/index.php ? Are you sure? I couldn't find any istance of S_MY_ACCOUNT.

crap you were fast. give me a second to check my work lmao