
Na een lange tijd van ontwikkelen is het dan zover. Een extensie voor joomla die het mogelijk maakt om informatie van SAM Broadcaster in een joomla site te tonen.
JooSam bestaat uit 1 component en 6 zichtbare modules en 1 onzichtbare module.
- 1. Component JooSam - Het JooSam component is het belangrijkste component. Alle modules hebben dit component nodig om te kunnen functioneren. Verder kunnen luisteraars en bezoekers via dit component verzoekjes doen. Deze verzoekjes zijn door de webmaster te beperken in categorieën.
2. Module NowLive - Deze module maakt het mogelijk om de song die nu gedraait wordt op SAM ook op de site te laten zien. Ook is er de mogelijkheid om een plaatje bij de artiest te tonen. Als 3e optie kan ook de tekst die door een luisteraar is verstuurd getoond worden op de site. Deze module verzorgt ook die functie.
3. Module Queue - Met deze module is het mogelijk om de aankomende 5 nummers op de site te tonen. (let wel op dat SAM de queue in de database opslaat.)
4. Module Geschiedenis/History - Deze module maakt het mogelijk om de laatste 5 afgespeelde nummers te tonen op de site.
5. Module TopRequest - Deze module laat een top5 vaan de meest aangevraagde nummers zien. (wanneer geen verzoekjes te tellen zijn zal Top5 meest afgespeeld worden. Wanneer dat niet te tellen is worden de eerste 5 nummers uit de database getoond op alfabetische volgorde.)
6. Module SchoutCast - Met deze module is het mogelijk om links op je site te tonen naar jouw stream. Zowel shoutcast v1 en v2 zijn mogelijk.
7. Module Event - Hiermee kunnen de JooSam evenement teksten getoond worden op de site. De titel van het evenement zal als module titel getoond worden en de overige tekst zal in de module content getoond worden.
8. Module Event Updater - De naam zegt het al. Wanneer er een evenement dagelijks of wekelijks herhaald moet worden zal deze module dat automatisch doen. Deze module is het beste om bijvoorbeeld in de footer te plaatsen. Deze heeft namelijk geen zichtbare output. Alleen javascript alert box wanneer updaten mislukt is.
Benodigdheden:
- - Een joomla 1.7 of hoger.
- Een SAM die via MySQL werkt
- Server met php ondersteuning: php 5.3.1+ wordt ondersteund.
Niet verplicht maar wel aangeraden
- php mcrypt (JooSam gebruikt dit om de wachtwoorden veilig op te slaan. Bij geen mcrypt wordt enkel base64 encode toegepast.)
Voor requests en LastFM
- php cURL
JooSam heeft standaard 2 talen in zich (nederlands en engels). Meerder talen zijn mogelijk. JooSam maakt namelijk gebruik van de joomla taal systeem. Verder is het mogelijk om bij JooSam een tijdzone in te stellen. Zodoende zal altijd de tijd van jouw SAM getoond worden op de site en niet de tijd van de gebruikers. (Let op! Niet alle php versies ondersteunen dit. Kijk hiervoor op php.net)
Voor het voorkomen dan modules en componenten op verschillende locaties te vinden zijn en daardoor lastig is om overal de juiste versie beschikbaar te is er besloten om alles alleen op http://www.scriptplanet.eu te bieden. Zo is er altijd de juiste versie beschikbaar voor iedereen. Alle support wordt ook daar gegeven zodat we een vraag ook maar 1x hoeven te beantwoorden.
URL naar downloadpagina: http://scriptplanet.eu/download/joosam (registratie verplicht).
Voorbeeld van werkende site met JooSam: http://shoutfm.nl