Csitemap

[tof06]

Hello everybody,

I've just committed to the component repository my first version of "CSitemap"

Well, what's this ?
Well, it's a set of modules and controls that permit to navigate easily in your site with a sitemap.xml files.
At the beginning, I just wanted a Bread Crumb component, as requested by p_e_t_e_r here
But, when I was writing this component, I saw other usages for sitemap.xml, and that's why I wrote this.

What is included in this release :

CSitemap is a set of Prado component to use the power of sitemap.xml files.

Main module : CSitemapManager
=============================
This module must be added to the global module section of you application.xml in order all provided component to work.
This module is responsible to parse the xml file, and make it available to other components.

Url Manager : CSitemapUrlManager
================================
This module is an extension of TUrlManager, providing short url using sitemap file. See doc in CSitemapUrlManager.php files for more info.


Web Control : CSitemapPath
==========================
This control can be placed anywhere in you template. It will display the current path of the requested page.


WebControl : CSitemapDropdownMenu
=================================
This control is an extension of the excellent LCssDropDownMenu written by schmunk
It displays a navigation drop down menu, based on information in the sitemap file.
You need the schmunk component somewhere in your application. It's not included here, except for the demo

See the demo folder as as example on how to use these components.
It's the blog tutorial demo, with a dropdown menu for navigation, and the bread crumb on top of the page.

Still differents things to implement (see TODO file), but it's working.

I'd love to read your comments, criticism (constructive ) about this.

Have fun.

Cheers,

Tof.

PS: Attached is a ZIP of the current version, for those who don't have svn...

[p_e_t_e_r]

wow, great, cant wait to try it out !

greets

[aztech]

How can I support urls with params? I mean I've forum, some subforums in it and there some topic. My CSiteMap for each topic should look like:
Forum -> SubForum -> MyTopic.
What I must to write in sitemap.xml?
update
I found in code as todo: "TODO: Make a CSitemapRegexpNode class, to handle regular expression in url and get parameters"
Anyway carma++ for that great component
P.S. When do you want to add this Regexp functionality?

[tof06]

Hi aztech,

Hmmm... For now, you can only have "static" navigation. I don't see how we can make this dynamic, as we don't know how many child board you can have.

What you can do, is in onInit of your forum page, add dynamic CSitemapPathNode to the Controls[] of CSitemapPath :

Template :

Code:

<com:CSitemapPath id="breadcrumb"/>

Class:

Code:

<?php
public function onInit ($param)
{
    /* Repeat this for each subnodes */
    $this->breadcrumb->getControls()->add(prado::createComponent('CSitemapPathNodeSeparator'));
    $dynamicNode=prado::createComponent('CSitemapPathNode');
    $dynamicNode->setTitle ("TheTitleYouComputeFromYourParameters");
    $dynamicNode->setUrl($this->Service->constructUrl(....);
    $this->breadcrumb->getControls()->add($dynamicNode)
}
?>

Your sitemap.xml will contains only the main board of your forum.

In the future, perhaps we can override the CSitemapManager Module, to allow creating dynamic nodes from a database, instead of a static xml file...

[aztech]

This is good idea. I'll check it and I'll tell you how it works. Thanks for quick answer.

[aztech]

What about this TODO: Make a CSitemapRegexpNode class, to handle regular expression in url and get parameters?
Do you have plans to extend this component?

[tof06]

Hi Aztech,

Sorry, but I didn't have time to update this component for now...
I'll try to think about it... I will need this functionality soon.
So, stay tuned... And if you want to help me, please do !
 

[aztech]

I'm still using this "dynamic" solution which you suggested, but it is more and more heavy in my application and with every added page is harder to manage.

[tiro]

Please help.
How should I do to use two menu?

Thank you.

[boydzethuong]

tof06: Thank you so much for this component. I am still waiting for CSitemapRegExpNode from you or someone else...