084 - Create a document entitled "How to include Squeezebox in your Joomla!

Google's Highly Open Participation Program tries to get young students into Open Source and Joomla! specifically. Everyone is welcome, there are not limits. You can be a coder, documenter, tester, translator to help out. Jump in and start helping!
ddcc
Joomla! Apprentice
Joomla! Apprentice
Posts: 20
Joined: Mon Dec 03, 2007 4:01 am

084 - Create a document entitled "How to include Squeezebox in your Joomla!

Post by ddcc » Mon Dec 03, 2007 4:23 am

Hi, I'm a high school student and I've claimed this task. I've already gotten started on installing XAMPP & Joomla on a virtual machine, however I've run into a couple of issues.
1) I should use Joomla 1.5 RC3, instead of the nightly right?
2) Exactly what is the Joomla! Electronic Documentation License?
3) What does it mean by use logo and color scheme?
4) File format should be open office text, correct?
5) What is the extra credit, and what would the distance be between regular and extra?


Claimed: Dec 02 Due: Dec 23

Google Task

[me=AmyStephen]Changed subject slightly for sorting all threads to match against Google resource  :)[/me]
Last edited by AmyStephen on Sat Dec 22, 2007 2:00 am, edited 1 time in total.

AmyStephen
Joomla! Champion
Joomla! Champion
Posts: 7018
Joined: Wed Nov 22, 2006 3:35 pm
Location: Nebraska
Contact:

Re: 084 - Create a document entitled "How to include Squeezebox in your Joomla!

Post by AmyStephen » Mon Dec 03, 2007 8:18 pm

Hi ddc -

Welcome to Joomla! and thanks for joining the GHOP contest.

I am going to start by responding to your five questions.

1) I should use Joomla 1.5 RC3, instead of the nightly right?

No. Please use the nightly download.

2) Exactly what is the Joomla! Electronic Documentation License?

Please check the wiki on the Joomla! GHOP website for the link to this license.

3) What does it mean by use logo and color scheme?

Again, on the wiki, you will find a link to this resource. For documentation, it is not as critical to follow this design guide as it is for marketing material, like a tri-fold. But, the wiki will have these links. Please read through that information.

4) File format should be open office text, correct?

Yes, Open Officer Writer .odt file is preferred.

5) What is the extra credit, and what would the distance be between regular and extra?

If your task identified something for extra credit, please consider that suggestion. In general, it's usually pretty easy to see effort that went beyond expectation. Give instructions using easy to follow steps. Add pictures. All of that helps produce helpful documentation and makes it easy for others to be productive.

Please read the thread GHOP Contestants Please Read: Task Process Start to Finish, which will help you to understand the process we need to follow with the contest.

Good luck! Look forward to seeing your progress,
Amy :)

ddcc
Joomla! Apprentice
Joomla! Apprentice
Posts: 20
Joined: Mon Dec 03, 2007 4:01 am

Re: 084 - Create a document entitled "How to include Squeezebox in your Joomla!

Post by ddcc » Mon Dec 03, 2007 10:44 pm

When I tried to use the nightly, after untarring to /opt/lampp/htdocs/joomla, everytime I tried to access localhost/joomla it gave me a 403 forbidden. I'll try again, but if it happens again, how should I fix that? I've tried modifying the htaccess file and chmod'ing before, but it didn't help.

User avatar
jlleblanc
Joomla! Guru
Joomla! Guru
Posts: 963
Joined: Fri Aug 19, 2005 12:37 am
Location: Washington, DC / NoVA
Contact:

Re: 084 - Create a document entitled "How to include Squeezebox in your Joomla!

Post by jlleblanc » Tue Dec 04, 2007 12:40 am

If you're having problems with the nightly snapshot, I would write the document while testing it on RC3, then test the final document on a different nightly snapshot before submitting. Nightly builds are not guaranteed to be stable, but I *usually* get a stable one at least half the time.

Edit: Or just try tomorrow.  :D
Joseph L. LeBlanc: http://www.jlleblanc.com
Frontend components start here: /components/com_[name]/[name].php
Backend components start here: /administrator/components/com_[name]/admin.[name].php

AmyStephen
Joomla! Champion
Joomla! Champion
Posts: 7018
Joined: Wed Nov 22, 2006 3:35 pm
Location: Nebraska
Contact:

Re: 084 - Create a document entitled "How to include Squeezebox in your Joomla!

Post by AmyStephen » Tue Dec 04, 2007 1:56 am

ddcc -

Not certain if you discovered the Installation Guide, or not? Also, it's unclear to me - did you complete the install? Or, get the 403 prior to the installation?

Thanks!
Amy :)

ddcc
Joomla! Apprentice
Joomla! Apprentice
Posts: 20
Joined: Mon Dec 03, 2007 4:01 am

Re: 084 - Create a document entitled "How to include Squeezebox in your Joomla!

Post by ddcc » Tue Dec 04, 2007 2:09 am

Yes, I followed the installation guide links from the original post over at google. It's just that when I tried to configure it through the browser at http://localhost/joomla, it would give me 403 forbidden. Trying to access the install.php directly gave the same thing.

AmyStephen
Joomla! Champion
Joomla! Champion
Posts: 7018
Joined: Wed Nov 22, 2006 3:35 pm
Location: Nebraska
Contact:

Re: 084 - Create a document entitled "How to include Squeezebox in your Joomla!

Post by AmyStephen » Tue Dec 04, 2007 2:59 am

ddcc -

Are you using XAMPP? What operating system?

Thanks!
Amy :)

ddcc
Joomla! Apprentice
Joomla! Apprentice
Posts: 20
Joined: Mon Dec 03, 2007 4:01 am

Re: 084 - Create a document entitled "How to include Squeezebox in your Joomla!

Post by ddcc » Tue Dec 04, 2007 3:10 am

Ubuntu 32-bit desktop in a virtual machine

AmyStephen
Joomla! Champion
Joomla! Champion
Posts: 7018
Joined: Wed Nov 22, 2006 3:35 pm
Location: Nebraska
Contact:

Re: 084 - Create a document entitled "How to include Squeezebox in your Joomla!

Post by AmyStephen » Tue Dec 04, 2007 3:18 am

Let me see if I can find someone to help.

Thanks!
Amy :)

ddcc
Joomla! Apprentice
Joomla! Apprentice
Posts: 20
Joined: Mon Dec 03, 2007 4:01 am

Re: 084 - Create a document entitled "How to include Squeezebox in your Joomla!

Post by ddcc » Tue Dec 04, 2007 3:28 am

I've just downloaded yesterday's nightly, but I probably won't get to testing it until this weekend. Tips on what to do if it happens again would help though. Thanks.

AmyStephen
Joomla! Champion
Joomla! Champion
Posts: 7018
Joined: Wed Nov 22, 2006 3:35 pm
Location: Nebraska
Contact:

Re: 084 - Create a document entitled "How to include Squeezebox in your Joomla!

Post by AmyStephen » Tue Dec 04, 2007 4:00 am

I believe Bruce PM'ed you. He's a Ubuntu Joomla! Developer geek (and an all around nice guy!)

Amy :)

ddcc
Joomla! Apprentice
Joomla! Apprentice
Posts: 20
Joined: Mon Dec 03, 2007 4:01 am

Re: 084 - Create a document entitled "How to include Squeezebox in your Joomla!

Post by ddcc » Tue Dec 04, 2007 2:53 pm

Yup, I've got it. Thanks for your help.

ddcc
Joomla! Apprentice
Joomla! Apprentice
Posts: 20
Joined: Mon Dec 03, 2007 4:01 am

Re: 084 - Create a document entitled "How to include Squeezebox in your Joomla!

Post by ddcc » Fri Dec 07, 2007 1:02 am

Thanks to Bruce, I've managed to get xampp + joomla up and running, however, I'm getting a little confused here, so I hope you can help me out.

Squeezebox: http://digitarald.de/playground/squeeze.html
Lightbox Forum Post: http://forum.joomla.org/index.php?topic ... .msg961421
Lightbox: http://www.huddletogether.com/projects/lightbox2

First off, are those links correct?
Secondly, Squeezebox = Lightbox, correct? Otherwise, what is Squeezebox?

Apologies if this is a really easy question, but I've never used Joomla before, so I'm a little confused by the terminology.
Last edited by ddcc on Fri Dec 07, 2007 1:05 am, edited 1 time in total.

ddcc
Joomla! Apprentice
Joomla! Apprentice
Posts: 20
Joined: Mon Dec 03, 2007 4:01 am

Re: 084 - Create a document entitled "How to include Squeezebox in your Joomla!

Post by ddcc » Sun Dec 09, 2007 4:19 am

Here's an update on my status:
I've got Joomla + XAMPP up and running on a virtual machine. I've already gone through the steps to get SqueezeBox working on a previous nightly, this is the current nightly and the one I plan to use for screenshots and documentation. I'll be writing up documentation both tonight and tomorrow, and will hopefully submit the pre-final draft by Monday. If I cannot do so for schoolwork or some other reason, I will submit the pre-final draft by next weekend. Either way, I hope to get criticism and peer reviewing done by the end of next weekend, so that I can finish it up that weekend, or if not possible, the Friday after (21st).

ddcc
Joomla! Apprentice
Joomla! Apprentice
Posts: 20
Joined: Mon Dec 03, 2007 4:01 am

Re: 084 - Create a document entitled "How to include Squeezebox in your Joomla!

Post by ddcc » Sun Dec 09, 2007 10:26 pm

OK. I've finished it up. Here's the pre-final draft: http://members.cox.net/sxzhu/joomla.zip

Edit: I've changed some bits since I first uploaded it, so you might want to download it again.
Last edited by ddcc on Mon Dec 10, 2007 4:15 am, edited 1 time in total.

AmyStephen
Joomla! Champion
Joomla! Champion
Posts: 7018
Joined: Wed Nov 22, 2006 3:35 pm
Location: Nebraska
Contact:

Re: 084 - Create a document entitled "How to include Squeezebox in your Joomla!

Post by AmyStephen » Mon Dec 10, 2007 6:07 am

This looks very, very good for a first draft.

In your images, consider using a long rectangle, instead of oval for the entire width of a page.

Double-check on a default install - I think much of the JS is already loading - so, loading it in the template would not be required. (for certain mootools.js is, I believe.)

Also, show a few images - how to create a little gallery - in your document, along with a single gallery and a popup page (all done nicely.)

Question: can you use multiple popups on one page? I think not. Try to address that question.

Amy :)

REVIEW: Let's get some community review on this.

ddcc
Joomla! Apprentice
Joomla! Apprentice
Posts: 20
Joined: Mon Dec 03, 2007 4:01 am

Re: 084 - Create a document entitled "How to include Squeezebox in your Joomla!

Post by ddcc » Fri Dec 14, 2007 5:09 am

I've fixed up all the other issues, but I can't get a SqueezeBox gallery to work. This is what I have so far:



However, when clicking on the link, nothing happens. Any help would be appreciated.

AmyStephen
Joomla! Champion
Joomla! Champion
Posts: 7018
Joined: Wed Nov 22, 2006 3:35 pm
Location: Nebraska
Contact:

Re: 084 - Create a document entitled "How to include Squeezebox in your Joomla!

Post by AmyStephen » Fri Dec 14, 2007 6:35 pm

ddcc -

Please provide your newest guide, and I'll try to follow the instructions and see where there might be a problem.

Thanks!
Amy :)

ddcc
Joomla! Apprentice
Joomla! Apprentice
Posts: 20
Joined: Mon Dec 03, 2007 4:01 am

Re: 084 - Create a document entitled "How to include Squeezebox in your Joomla!

Post by ddcc » Fri Dec 14, 2007 11:15 pm

OK. I've uploaded it, same URL. Keep in mind that the instructions for the gallery on there doesn't work, and that fig. L isn't up because I haven't got the gallery working yet.

ddcc
Joomla! Apprentice
Joomla! Apprentice
Posts: 20
Joined: Mon Dec 03, 2007 4:01 am

Re: 084 - Create a document entitled "How to include Squeezebox in your Joomla!

Post by ddcc » Tue Dec 18, 2007 2:33 am

How is the document? What else do I need to correct?

AmyStephen
Joomla! Champion
Joomla! Champion
Posts: 7018
Joined: Wed Nov 22, 2006 3:35 pm
Location: Nebraska
Contact:

Re: 084 - Create a document entitled "How to include Squeezebox in your Joomla!

Post by AmyStephen » Tue Dec 18, 2007 2:48 pm

ddcc -

I don't have time to debug it right now, but your #5 header javascript is not working.



 
    //
 
 
// " at the end. Maybe that's all, I don't know?

Try to fix it - replace it in your document - then, test what's in your document and I'll try it when you post it.

Thanks!
Amy :)

ddcc
Joomla! Apprentice
Joomla! Apprentice
Posts: 20
Joined: Mon Dec 03, 2007 4:01 am

Re: 084 - Create a document entitled "How to include Squeezebox in your Joomla!

Post by ddcc » Tue Dec 18, 2007 2:52 pm

I must have accidentally changed the Javascript on accident. I know I have the correct version that works at home, but I'm at school right now, so it'll be this afternoon before I get to it.

AmyStephen
Joomla! Champion
Joomla! Champion
Posts: 7018
Joined: Wed Nov 22, 2006 3:35 pm
Location: Nebraska
Contact:

Re: 084 - Create a document entitled "How to include Squeezebox in your Joomla!

Post by AmyStephen » Tue Dec 18, 2007 3:01 pm

No problem - looking forward to it! Thanks for the quick response!  8)

Amy

ddcc
Joomla! Apprentice
Joomla! Apprentice
Posts: 20
Joined: Mon Dec 03, 2007 4:01 am

Re: 084 - Create a document entitled "How to include Squeezebox in your Joomla!

Post by ddcc » Tue Dec 18, 2007 11:34 pm

Apparently the ending script tags were cut off by the text box, though I'm not sure how the open script tag appeared. The correct version is below, and I've already updated the zip file.




 
    //
 

//

AmyStephen
Joomla! Champion
Joomla! Champion
Posts: 7018
Joined: Wed Nov 22, 2006 3:35 pm
Location: Nebraska
Contact:

Re: 084 - Create a document entitled "How to include Squeezebox in your Joomla!

Post by AmyStephen » Wed Dec 19, 2007 4:50 am

ddcc -

change:
to:
baseurl ?>/media/system/js/modal.js">
baseurl ?>/media/system/css/modal.css" type="text/css" />
Amy :)

ddcc
Joomla! Apprentice
Joomla! Apprentice
Posts: 20
Joined: Mon Dec 03, 2007 4:01 am

Re: 084 - Create a document entitled "How to include Squeezebox in your Joomla!

Post by ddcc » Wed Dec 19, 2007 5:26 am

Fixed and uploaded. Does that apply to all URL's too? Like image paths and etc?

AmyStephen
Joomla! Champion
Joomla! Champion
Posts: 7018
Joined: Wed Nov 22, 2006 3:35 pm
Location: Nebraska
Contact:

Re: 084 - Create a document entitled "How to include Squeezebox in your Joomla!

Post by AmyStephen » Wed Dec 19, 2007 5:39 am

Yes, it does.

BTW - Bruce and I were unable to get the Gallery working.  :P

At this point - I'd add a statement to that effect.

Also, Bruce *just* pointed out to me that ToolTips break with Squeeze box in use. So, go ahead and add that statement, too.

If we can figure something out, we can change it - but for now, I think that's all we know.

Squeezebox can be used one time on a page for a single image or a single webpage. Given our collective knowledge between the three of us. If someone can show more - please do!

Finish up the doc and post it and we'll try to get this finalized.

Thanks ddcc! And, Bruce for all your help on this task!
Amy :)

ddcc
Joomla! Apprentice
Joomla! Apprentice
Posts: 20
Joined: Mon Dec 03, 2007 4:01 am

Re: 084 - Create a document entitled "How to include Squeezebox in your Joomla!

Post by ddcc » Wed Dec 19, 2007 5:07 pm

OK. Fixed and uploaded.

AmyStephen
Joomla! Champion
Joomla! Champion
Posts: 7018
Joined: Wed Nov 22, 2006 3:35 pm
Location: Nebraska
Contact:

Re: 084 - Create a document entitled "How to include Squeezebox in your Joomla!

Post by AmyStephen » Fri Dec 21, 2007 10:08 pm

ddcc -

I do not see your document. It needs to be uploaded to your Google task. Let me know when it's there. Thanks!

Amy :)

ddcc
Joomla! Apprentice
Joomla! Apprentice
Posts: 20
Joined: Mon Dec 03, 2007 4:01 am

Re: 084 - Create a document entitled "How to include Squeezebox in your Joomla!

Post by ddcc » Fri Dec 21, 2007 10:29 pm

OK uploaded.


Locked

Return to “Google's Highly Open Participation Contest”