Page 1 of 1

099 - Write a document describing how to add JavaScript and CSS from an extensi

Posted: Tue Jan 08, 2008 8:33 am
by fealebenpae
Hello, nice Joomla folk :)

This time I'll work on this task:
One line summary
Write a document describing how to add JavaScript and CSS to the page from
an extension.

Description
Although it is possible to output JavaScript and CSS fragments, or
references to external files containing JavaScript or CSS, by constructing
the HTML directly, it is cleaner and simpler to use the Joomla! 1.5 API
calls. This document should describe when and how to use each of the
relevant API calls.

The document should comply with current Joomla! Editorial Style Guidelines
and guidelines for the Template Tutorials Project.

Documentation written for this task must be made available under the
Joomla! Electronic Documentation License.

Skills Needed
Prior knowledge of PHP would be useful.

Difficulty
Basic.

Work Product
Document as described above.

Extra Credit (optional)
Check the wiki API reference for all the classes and methods referred to in
the document and suggest additions and improvements that could be made. For
example, class/method descriptions, cross-references, code samples, etc).

Check the Joomla! source code for the classes and methods referred to in
the document and suggest additions and improvements that could be made to
the phpdoc tags.

Time Limit
2 weeks.

Re: 099- Write a document describing how to add JavaScript and CSS from an exten

Posted: Tue Jan 08, 2008 2:09 pm
by AmyStephen
Can you add L33t to that? hehe! Just kidding...  :P

Do you need anything, my friend, or can you write this very important developer document in your sleep?

Thanks for coming back and doing another one. You are a very promising developer and we appreciate you very much!

Amy :)

Re: 099- Write a document describing how to add JavaScript and CSS from an exten

Posted: Mon Jan 21, 2008 1:51 am
by AmyStephen
Hey dude - hows it going? It you get a chance - give us a holler!

Amy :)

Re: 099 - Write a document describing how to add JavaScript and CSS from an exte

Posted: Wed Jan 23, 2008 6:42 pm
by AmyStephen
fealebenpae -

We are nearing the end of the contest and i know things get very busy. I hope you are still planning to participate on this task. If, for some reason you cannot, that's okay, too.

Please let us know at your earliest convenience.

Thanks!
Amy

Re: 099 - Write a document describing how to add JavaScript and CSS from an exte

Posted: Thu Jan 24, 2008 1:35 am
by fealebenpae
I'll never try documentation again  ;D It was worse than leet, honestly. Also, don't get me started on Bulgarian Matura exams - whoever came up with this idea has to be shot.

I wouldn't call this attempt successful, mostly due to the little time I had and my innate inability to compose a document readable and understandable for normal human beings.

Although in some cases I could have included JHTML::script and JHTML::stylesheet, I chose not to do so because I think that the JDocument approach is more consistent and frankly, in my opinion those two functions are just wrappers and I can't see the point in them.

I've included thorough code examples, which I think can be used in the API reference. On a side note, by reading the reference I couldn't understand what the $attribs argument in JDocument::addStyleSheet is used for and I think this need attention. I didn't mention $attribs in the document.

Let me know what you think and how I can improve my "tutorial".

Cheers,
Yavor :)

Re: 099 - Write a document describing how to add JavaScript and CSS from an exte

Posted: Thu Jan 24, 2008 4:14 am
by AmyStephen
Yavor -

I am always so happy to see you. Thanks!

I will let the documentation folks know a) you have brought in a tutorial and b) you feel better suited for development work.  ;)

Honestly, finding out what one doesn't like to do is valuable, too. I am glad you tried it and it says much about your character that you delivered it.

We'll talk later,
Amy :)

PS - you are really funny.

Re: 099 - Write a document describing how to add JavaScript and CSS from an exte

Posted: Thu Jan 24, 2008 9:48 am
by fealebenpae
I'd have liked the Facebook task, but then again it's good I couldn't claim it, otherwise I would have botched it with my lack of time this last month. End of the first term in senior year sux0rz  ;D

You're right - it's more than useful to know what you can do and what you can't. GHOP has been a revelation in this part :)

I plan on continuing development in the summer because I have a couple of ideas my fingers are just itching to implement. And who knows, I might show up on these forums next year in Summer of Code?  ;D

Re: 099 - Write a document describing how to add JavaScript and CSS from an exte

Posted: Wed Jan 30, 2008 9:51 pm
by Chris Davenport
Hi Yavor,

This is really very good work.  :)

The only fault I would pick you up on is that the text switches into a pure monospaced font ("Monaco") near the top of page 2.  Only the example code should be monospaced, the regular text should be in the proportional typeface used elsewhere.

Apart from that, an excellent piece of work.  :)

Regards,
Chris.

Re: 099 - Write a document describing how to add JavaScript and CSS from an exte

Posted: Wed Jan 30, 2008 10:04 pm
by fealebenpae
Thanks for replying, Chris.

Ugh, I must be font-blind  ;D

I'm uploading a fixed version.

Re: 099 - Write a document describing how to add JavaScript and CSS from an exte

Posted: Wed Jan 30, 2008 11:08 pm
by AmyStephen
Chris Davenport wrote: Apart from that, an excellent piece of work.  :)
And you say you are no good at documentation!

The fonts look good and Chris liked your work, so go ahead and upload it to Google and we will close this one down.

Please, Yavor, do not be a stranger - hope to see you around, again!

Take care - thanks for all you have done for our community!
Amy :)

Re: 099 - Write a document describing how to add JavaScript and CSS from an exte

Posted: Thu Jan 31, 2008 12:56 am
by fealebenpae
Just because it turned out good doesn't mean I'll do it again, if I have a choice :-D

Anyway, thanks for all your help, Amy, you were really wonderful - to everyone, and all the other J! people who sacrifaced a bit of their time to help me out as well. To tell the truth, my college application essay was about GHOP and the open source community in general, because that's something that influenced me A LOT! I really enjoyed participating and I'm glad I was of some service :)

I should check out how the guy with the facebook application is doing - maybe he'd like to team up after the contest or something.

Night, folks :)

Re: 099 - Write a document describing how to add JavaScript and

Posted: Mon Feb 18, 2008 11:22 am
by DeZzL
Attachments
[The extension odt has been deactivated and can no longer be displayed.]
I'd love to be able to download that document!

Re: 099 - Write a document describing how to add JavaScript and

Posted: Mon Feb 18, 2008 11:40 am
by fealebenpae
DeZzL, here's a link to the document: http://help.joomla.org/ghop/feb2008/tas ... %20099.odt