Annotated 1.5 Component

Submit your own tutorials, guides and API documents for inclussion in the Official Developer Documentation.
Locked
Narcissus
Joomla! Enthusiast
Joomla! Enthusiast
Posts: 109
Joined: Wed Sep 07, 2005 5:02 pm

Annotated 1.5 Component

Post by Narcissus » Fri Feb 02, 2007 3:09 am

Hi all,

As per the thread I started at http://forum.joomla.org/index.php?topic=137174 , I would like to present the following attachment as my first attempt at helping the documentation process.

Essentially, the idea was to 'annotate' an existing component so that developers with a basic understanding of Joomla! can read through the code and with my notes understand the basics of how things may operate.

At the moment, all I've done is the administrator side of the weblinks component. When I get a chance, I'll go through the front-end portion of the component, too.

In the attached ZIP you will find two directories: the first is the original com_weblinks directory that is found under the administrator/components directory (I am using the 1.5 Beta release). The other directory is called com_weblinks_annotated and contains my comments in the same files. All of my comments / notes are marked with 'DEVNOTE:' at the start of them. You can either run a diff program to see my exact comments or hopefully just be able to read through the files and by paying special attention to my notes be able to understand a lot of the basics of building a component.

This is my first effort and it only represents what I *think* is correct... so I'm happy to be told if I got something wrong! At the same time, I have left out certain things that I found self-explanatory.

The target audience is definitely not a novice PHP programmer... maybe closer to an intermediate PHP programmer with a basic understanding of Joomla!

Please, feel to make comments etc.

Thanks,
Lincoln.
You do not have the required permissions to view the files attached to this post.

User avatar
Chris Davenport
Joomla! Ace
Joomla! Ace
Posts: 1384
Joined: Thu Aug 18, 2005 8:57 am
Location: Shrewsbury, Shropshire, United Kingdom

Re: Annotated 1.5 Component

Post by Chris Davenport » Fri Feb 02, 2007 9:58 pm

Hi Narcissus,

I haven't had time to digest it thoroughly yet, but I like what I see.  8)

Give me some time to think about how we might use this.  I'll get back to you in a day or two.

Thank you very much for your contribution.  It really is appreciated.  :)

Regards,
Chris.
Chris Davenport

Davenport Technology Services http://www.davenporttechnology.com/
Lion Coppice http://www.lioncoppice.org/

User avatar
brian
Joomla! Master
Joomla! Master
Posts: 11722
Joined: Fri Aug 12, 2005 7:19 am
Location: Leeds, UK
Contact:

Re: Annotated 1.5 Component

Post by brian » Fri Feb 02, 2007 10:00 pm

I've added this to the current issue of Joomla Weekly News to see if it gets any extra interest for you there
"Exploited yesterday... Hacked tomorrow"
Blog http://brian.teeman.net/
Joomla Hidden Secrets http://hiddenjoomlasecrets.com/

Narcissus
Joomla! Enthusiast
Joomla! Enthusiast
Posts: 109
Joined: Wed Sep 07, 2005 5:02 pm

Re: Annotated 1.5 Component

Post by Narcissus » Tue Mar 06, 2007 3:03 pm

Hi all... just wanted to give a quick update. As noted previously, the version I annotated was 1.5 Beta. I finally got around to installing one of the nightlies and realised that the Weblinks component has now been done in MVC form.

I will get around to redoing the notes but I just wanted anyone who was looking at this to understand that there have been some massive changes in this particular component since Beta. Having said that, my notes still stand for a lot of it and so I believe it's still a decent start... just not as good as the one that will be available once I get time to tackle the latest version :)

User avatar
ianmac
Joomla! Virtuoso
Joomla! Virtuoso
Posts: 4785
Joined: Sat Sep 24, 2005 11:01 pm
Location: Toronto, Canada

Re: Annotated 1.5 Component

Post by ianmac » Tue Apr 17, 2007 3:29 pm

Sorry that you didn't get a reply more quickly, Narcissus.

There have certainly been a lot of changes made to the way components are done.  Let me know if there is anything we can do to help support you!

Ian

Narcissus
Joomla! Enthusiast
Joomla! Enthusiast
Posts: 109
Joined: Wed Sep 07, 2005 5:02 pm

Re: Annotated 1.5 Component

Post by Narcissus » Tue Apr 17, 2007 4:26 pm

Hi Ian,

Thanks for the reply... to say that there have been a lot of changes is an understatement, but it's great to be able to watch the evolution of the Joomla code.

At the moment, I'm neck-deep in doing some work in J1.5 so for the time being, at least, I'm going to stick with the old school way of doing things until I actually get this work out of my hair. Once that's done, I'll start looking into it all again.

Again, thanks for the reply. Cross your fingers for me and hope I win the Lotto... if I do, I can get back to this a lot sooner. It'll be a win for everyone! :)


Locked

Return to “Submit”