|
Search:
Advanced search
|
Browse by category:
|
Submit your own Question |
Wiqet implementatie Document Nederlands |
|||||
DIT IS EEN OUDE VERSIE VOOR NON GLOBAL WIQET. ZIE GLOBAL DOCUMENTATIE VOOR GLOBAL VERSIE.Wiqet implementatiedocument Versie: 2.4.4
Datum: 10-07-2009 Inhoudsopgave
Beginnen met Wiqettop Waar dient u over te beschikken?Om van start te gaan met het implementeren van Wiqet dient u het volgende materiaal van ons te hebben ontvangen:
top Maak zelf een Wiqet aanMaak eerst zelf een Wiqet aan op (http://www.wiqet.com) zodat u de basisprincipe en de applicatie beter kunt begrijpen en implementeren. De Wiqet beschreven in dit document verschilt met de voorbeeld Wiqet in zoverre, dat de voorbeeld Wiqet alleen via email beheerd kan worden.top SupportAlgemene vragen Mocht u algemene vragen hebben over het gebruiken van Wiqet of over dit document, dan kunt u een email sturen naar info@wiqet.com of telefonisch contact opnemen met 020-4230500 Technische vragen Mocht u technische vragen hebben over het implemeren van een Wiqet, dan verzoeken wij een e-mail te sturen naar support@wiqet.com met daarin een zo'n duidelijk mogelijke beschrijving van het probleem. Indien mogelijk met zoveel mogelijk relevanten informatie code, url's, eventueel inlogggevens. Mocht er een acute technische complicatie zijn dan kunt u, bij nood, ook telefonisch contact opnemen met Sequential media 033-4625067top Uitleg werking WiqetDe Wiqet bestaat uit drie flash-bestanden (de player.swf, de editor_photo.swf en de editor_video.swf ) deze worden aangestuurd via javascript. Wij raden u aan om een aparte pagina voor de player en de editor te maken (bijvoorbeeld player.php en editor.php). De editor zorgt ervoor dat u een Wiqet kunt aanmaken, de player zorgt ervoor dat de aangemaakte Wiqet wordt afgespeeld op de door u gewenste pagina's.top Foto editorEen foto Wiqet bestaat uit 1 of meer plaatjes en eventueel 1 audio bestand (ingesproken via de computer, telefoon of mp3 upload), de foto editor zorgt ervoor dat de gebruiker de Wiqet kan aanmaken. De data, welke beschikbaar is binnen een Wiqet, wordt op de Wiqetserver bewaard en kan, indien gewenst, worden verplaatst naar uw server. Dit gebeurt door middel van een XML koppeling. U dient aan te geven naar welke URL deze XML kan worden gepost. Indien u wenst dat er ook plaatjes worden overgestuurd, dient u er rekening mee te houden dat het XML bestand erg groot wordt. Indien u data op uw server bewaart, dient u deze beschikbaar te maken voor de Wiqet. Voor deze communicatie is het essentieel dat u een unieke code meestuurt waarmee wij kunnen communiceren. Daarnaast krijgt u dan van ons een Wiqet code, dit is een unieke code waarmee u uw Wiqet kunt afspelen.top Video editorEen video Wiqet bestaat uit 1 video of webcam bestand. De video editor zorgt ervoor dat de gebruiker de Wiqet kan aanmaken. De data, welke beschikbaar is binnen een Wiqet, wordt op de streaming Wiqetserver bewaard. Omdat de video streaming draait, dat wil zeggen: hij wordt onafgebroken afgespeeld, de video hoeft niet ingeladen te worden maar wordt live vanaf de server afgespeeld, is het niet mogelijk om de bestanden naar uw eigen server over te dragen. Als dit toch wenselijk is kunt u contact opnemen met Wiqet support om te kijken wat eventuele mogelijkheden zijn.top Editor implementerenDe editors (editor_photo.swf en editor_video.swf) maken het mogelijk Wiqets aan te maken binnen uw eigen website en deze te koppelen aan uw eigen database. De reeds gemaakte Wiqets kunnen later vanuit de editor ook bewerkt worden.top Wiqet editor uploaden naar uw webserverPlaats de editor_photo.swf en de editor_movie.swf op uw webserver zodat uw pagina's deze kunnen inladen.top Wiqet editor plaatsen in uw webpaginaVervolgens moet er code worden opgenomen in de HTML pagina om het flash bestand en de koppeling naar de Wiqet server te realiseren. Afbeelding: voorbeeld van de foto editor Afbeelding: voorbeeld van de video editor Plaats bepalen De plaats van de editor bepaald u door de volgende div-element binnen uw webpagina te plaatsen: <div id="flashWiqet">Wiqet wordt geladen...</div>
Binnen dit element wordt het flash bestand geplaatst. Voor een goede afhandeling van de Wiqet dient u ook het volgende element op uw webpagina te plaatsen: <div id="flashWiqet">Formulier wordt geladen...</div>
Dit element moet geplaatst worden tussen <form></form> In dit element zullen hidden fields worden geplaatst. Wanneer u het formulier verstuurd (submit) worden de volgende codes aan u bekend gemaakt: - de aangemaakte Wiqetcode - de twee codes welke nodig zijn om een Wiqet van de Wiqetserver te verwijderen Wanneer het formulier wordt verzonden wordt er een extra variabele meegestuurd. Deze wordt gevuld met de data uit het bovenstaande element. Deze naam "IVFormName" (zie: Scriptregels voor de editor) is aanpasbaar. Het is belangrijk dat u de data van deze variabele bewaart bij de unieke code die u naar de editor heeft gestuurd. top De scriptregels voor de editorOm de editor op uw webpagina te tonen, kunt u onderstaande code toevoegen aan uw pagina. Alles tussen brackets ([ ]) dient u te vervangen, inclusief de brackets zelf. In de onderstaande code is een formuliervoorbeeld geplaatst. Na het inspreken van de Wiqet zal de informatie vanuit de editor in het formulier worden geplaatst. ZEER BELANGRIJK:
U kunt het onderstaande voorbeeld kopiëren en plakken naar uw editor HTML webpagina. <!---start copy paste here--> <div id="flashWiqet">Wiqet is loading...</div> <div id="linkWiqet"></div> <form method="post"> <div id="formWiqet">Form is loading...</div> </form> <script src="http://backend.wiqet.com/2.0/Wiqet.js" type="text/javascript"></script> <script type="text/javascript"> var IVcustomerId = '[customerid]'; var IVuniqueId = '[uniqueid]'; //Cannot be empty! var IVWiqetCode = '[WiqetCode]'; var IVplayerUrl = 'editor.swf'; var IVDisplayUrl = '[displayurl]'; var IVwidth = '450px'; var IVheight = '375px'; var IValign = 'middle'; var IVbgColor = '#ffffff'; var IVdivForm = 'formWiqet'; var IVdivPlayer = 'flashWiqet'; var IVdivLink = 'linkWiqet'; var IVFormName = 'Wiqet'; var IVFormnameType = 'text'; //or hidden var error = play_wiqet(IVDisplayUrl,IVplayerUrl,'editor', IVWiqetCode,IVcustomerId,IVuniqueId,IVwidth,IVheight,IValign,IVbgColor,IVdivLink,IVdivForm,IVdivPlayer,IVFormName,IVFormnameType, '', ''); if (error) document.write(error); </script> Wanneer u de output velden van het formulier (Wiqet player url, Wiqet code, delete code & delete pincode, zie ook bijlage 2) niet zichtbaar wilt hebben met de informatie van de editor na het inspreken van een Wiqet, dan kunt u de variabele "IVFormnameType" veranderen naar hidden. De tekstvelden zullen als hidden field worden meegezonden met het formulier. Het div-element <div id="linkWiqet"></div> top Opslaan Wiqettop Wiqet photoU kunt een Wiqet photo op 2 manieren opslaan, dit kan via de Wiqetserver (methode 1) of via uw server (methode 2). Standaard is de foto editor zo opgemaakt dat de opslaan knop in de editor wordt weergegeven. Indien u kiest voor Methode 2 kunt u dit aan ons doorgeven (info@wiqet.com) en zullen wij u een nieuw editor bestand, zonder opslaan knop, toesturen.top Methode 1: opslaan via de Wiqet server (standaard)De standaard methode om een Wiqet op te slaan is binnen de editor. De editor slaat alle gegevens op in de Wiqet database. Deze gegevens worden teruggekoppeld door middel van een Get statement (URL met variabelen). Nadat de gebruiker de zojuist aangemaakte Wiqet in de editor heeft opgeslagen, stuurt de Wiqetserver de benodigde gegevens voor de Wiqet terug. Dit gebeurt in de vorm van een array m.b.v. een, door u aangegeven, URL. Via de volgende PHP notatie kunt u de gegevens uit de array halen:$_GET['Wiqet']['IVWiqetCode'] Dit is de wiqetCode waarmee u kunt aangeven welke Wiqet u wilt afspelen. $_GET['Wiqet]['IVDeleteCode'] Dit is de delete code. $_GET['Wiqet]['IVDeletePinCode'] Dit is de delete pincode. $_GET['Wiqet]['IVCustomerUniqueId'] Dit is uw unieke code. Al deze gegevens kunt u, op uw eigen manier, opslaan in uw database. In het hoodstuk 'Editor implementeren' ziet u hoe u deze codes kunt gebruiken om een reeds aangemaakte Wiqet te wijzigen. top Methode 2: opslaan via uw eigen serverIndien gewenst kunt u de Wiqet op uw eigen server opslaan. De editor plaatst dan een aantal benodigde gegevens (hidden) binnen een, door u gegenereerd, HTML formulier. Het is belangrijk dat, wanneer u dit formulier submit, de javascriptfunctie publish(); wordt aangeroepen, alvorens het formulier daadwerkelijk te versturen. Op deze manier wordt aan de Wiqetserver duidelijk gemaakt dat de Wiqet klaar is.� Dit kan op de volgende manieren:<a href="javascript:publish();">Save Wiqet</a> <input type="button" onClick="javascript:publish();" value="Save Wiqet" name="save_wiqet" /> <input type="button" onClick="javascript: publishAndSubmit(this.form);" value="Wiqet opslaan" name="save and send form" /> IVWiqetCode IVDeleteCode IVDeletePinCode top Wiqet videoDe Wiqet video wordt op 1 manier opgeslagen; op de Wiqet streaming server. Omdat de video streaming afspeelt is het niet mogelijk om de bestanden naar uw eigen server over te dragen. Als dit toch wenselijk is kunt u contact opnemen met Wiqet support om te kijken wat eventuele de mogelijkheden zijn.top Feedback wanneer een Wiqet is opgeslagenIndien u, nadat de Wiqet is opgeslagen nog javascript code wilt uitvoeren, dan kunt u de functie "onWiqetSaved" aanmaken in uw javascript.<script type="text/javascript"> <!---start copy paste here--> function onWiqetSaved(){ //evoke event } </script> top Player implementerenDe player kan de Wiqet welke gecreëerd is uit de photo editor alsook de Wiqet welke gecreëerd is uit de video editor afspelen. De basisfuncties van de player zijn het laten zien van de foto's, het afspelen van de audio of het afspelen van de video. Naast het automatisch doorlopen van de foto's in synchronisatie met het geluid, kan een gebruiker ook afzonderlijk de foto's bekijken. Afbeelding: voorbeeld player top Wiqet player uploaden naar uw webserverPlaats de player.swf op uw webserver zodat uw pagina's deze kunnen inladen.top Wiqet player plaatsen in uw webpaginaVervolgens moet er code worden opgenomen in de HTML pagina om het flash bestand en de koppeling naar de Wiqet server te realiseren.Plaats bepalen De plaats van de player bepaalt u door de volgende div-element binnen uw webpagina te plaatsen: <div id="flashWiqet">Wiqet wordt geladen...</div>
Binnen dit element wordt het flash bestand geplaatst. Binnen het script van de player, moet de Wiqetcode worden geplaatst. Deze code wordt in de URL meegestuurd mbv de variabele 'code' en dient door serverside scripting te worden uitgelezen. Hiervoor kan bijvoorbeeld PHP gebruikt worden: IVWiqetCode =' <?php echo $_GET['code'];?>'; top De scriptregels voor de playerOm de Wiqet player op uw webpagina te tonen, kunt u onderstaande code toevoegen aan uw pagina. . Alles tussen brackets ([ ]) dient u te vervangen, inclusief de brackets zelf.<!---start copy paste here--> <div id="flashWiqet">Wiqet wordt geladen...</div> <script src="http://backend.wiqet.com/2.0/Wiqet.js" type="text/javascript"></script> <script type="text/javascript">
var uniqueXMLid = '[uniqueXMLid]'; var IVplayerUrl = 'player.swf'; var IVwidth = '454px'; var IVheight = '383px'; var IValign = 'middle'; var IVbgColor = '#ffffff'; var IVdivPlayer = 'flashWiqet'; var error = play_wiqet("", IVplayerUrl, 'player', IVWiqetCode, "","",IVwidth, IVheight, IValign,IVbgColor, "", "",IVdivPlayer, "", "", "", ""); if (error) document.write(error); </script> <!---end copy paste here--> top Optioneeltop Player en editor in eigen huisstijlU krijgt standaard de beschikking over een neutrale Wiqet player en editor. Het is mogelijk dat we deze opmaken naar de huisstijl van uw website. O.a. de kleur en vormgeving kunnen aangepast worden. Hier zijn echter additionele kosten aan verbonden. Ook voor toekomstige updates worden kosten berekend.� Indien u hier meer over wilt weten kunt u rechtstreeks contact met Wiqet Media opnemen via support@wiqet.com of door te bellen met 020-4230500top Verwijderen WiqetVerwijderen van de Wiqet kan alleen via een pagina op de website van de Wiqetserver. Wij raden aan om dit alleen te gebruiken als u de Wiqet echt fysiek wilt verwijderen. Als u gegevens uit uw eigen database wilt verwijderen dan kunt u dat zelf doen. Om een Wiqet niet meer beschikbaar te maken binnen bijvoorbeeld een gebruikersprofiel, zou dit al volstaan. Om een Wiqet fysiek te verwijderen surft u naar het volgende adres: http://www.introvoice.nl/2.0/?d=[code] Hierbij dient u [code] te vervangen door de 'deletecode' die wordt gegenereerd na het aanmaken van een Wiqet. Vervolgens voert u de pincode in, waarna de Wiqet volledig is verwijderd (voor het verkrijgen van deze codes; zie hoofdstuk 'Opslaan Wiqet'). Het verwijderen van een Wiqet is definitief en kan niet ongedaan gemaakt worden. Wij adviseren daarom een Wiqet niet te verwijderen, maar een nieuwe aan te maken.top Wiqet player logoIndien gewenst kunt u een eigen logo in de player over de foto's heen plaatsen. Wij adviseren een logo dat maximaal rond de 50 bij 50 pixels is, deze grootte brengt het logo het beste tot zijn recht in de player. Ook kan er een URL naar keuze aan het logo worden gekoppeld. Deze kan statisch, maar ook dynamisch zijn. Een statische URL is bijvoorbeeld: www.uwdomein.nl. Een dynamische URL is een URL met daarin de wiqetcode. Bijvoorbeeld: www.uwdomein.nl/speelwiqet.php?wiqetCode=1223456 Als u de wiqetcode aan uw url wilt plakken kunt u dit bij ons opgeven. Wij zorgen dat de desbetreffende Wiqetcode automatisch aan deze URL komt te hangen. Het voordeel van deze laatste methode is dat de Wiqet presentatie te allen tijde doorlinkt naar de website (bronpagina) waar de Wiqet oorspronkelijk wordt afgespeeld. U bent vrij om hier een URL naar keuze in te plaatsen maar u dient wel zelf de technische kant af te handelen; de interpretatie van de pagina die u opgeeft en het weergeven van de juiste presentatie in de Wiqet player. Het logo kunt u, samen met de URL waarnaar hij moet verwijzen en de positionering (links, rechts, boven of onder) versturen naar info@wiqet.com. Wij zorgen dan dat het logo in de player komt te staan. Tip: Vergeet niet uw browsercache te legen bij het aanmaken van een nieuwe logo zodat alle veranderingen ook zichtbaar zullen zijn.top XML koppelingentop Externe foto's gebruikenVoor de foto editor en player is het mogelijk om, via XML, foto's extern in te laden. Het XML bestand dat u aan uw serverkant moet plaatsen dient de opmaak te hebben zoals hieronder is gedefinieerd. Voor de editor en de player dient de XML op een bepaalde manier oproepbaar te zijn:
<xml> <introvoice> <images> <image>http://www.uwbedrijf.nl/media/1.jpg</image> <image>http://www.uwbedrijf.nl/media/2.jpg</image> <image>http://www.uwbedrijf.nl/media/3.jpg</image> <image>http://www.uwbedrijf.nl/media/4.jpg</image> </images> </introvoice> </xml> Standaard wordt de editor met een eigen foto-upload knop opgeleverd. Als u niet wilt dat gebruikers zelf foto's uploaden, maar dat dit alleen gebeurd via het extern in laden van foto's, dan kunnen wij deze knop verwijderen. U kunt dit door geven via support@wiqet.com en ontvangt dan een nieuwe editor, zonder upload knop. Met deze nieuwe editor_photo.swf kunt u de oude simpelweg overschrijven. top Data naar uw eigen server sturen.Als u de data van de Wiqet op uw eigen server op wilt slaan kunt u gebruik maken van onderstaande mogelijkheid. Om deze mogelijkheid te implementeren is kennis van XML en server-side scripting vereist. Aangezien de volgorde, het toevoegen het bewerken van de foto's via de editor gebeurt, is het van belang dat de RAW data naar uw server wordt gestuurd. Dit houdt in dat de volgorde (welke aangepast kunnen zijn) en de (bewerkte!) data van de foto's in het XML bestand staan. Bij een bewerking van de Wiqet, dient u alle data te overschrijven. Beide worden meegestuurd in de XML. Een url kan zijn: http://www.uwdomein.nl/xml/photos.php?id=12345 De url dient u aan te leveren bij Wiqet Media (support@wiqet.com), zodat wij deze in ons systeem kunnen implementeren. Hieronder staat de opmaak van de xml die naar u wordt gestuurd. Let op: de CDATA tag voor de data van de images (deze wordt enkel op verzoek meegestuurd) is gecodeerd met de methode BASE64.<?xml version="1.0" encoding="UTF-8" ?> <introvoices> <introvoice> <head> <introvoiceCode></introvoiceCode> <uniqueId></uniqueId> </head> <files> <images> <file> <url><![CDATA[http://www.uwdomein.nl/xml/photos.xml.asp?adId=2&introvoicecode=dnddmgkmamy&img=25]]></url> <data><![CDATA[DATAXXXXXXXXXXXXXXX]></data> </file> <file> <url><![CDATA[http://www.uwdomein.nl/xml/photos.xml.asp?adId=2&introvoicecode=dnddmgkmamy&img=28]]></url> <data><![CDATA[DATAXXXXXXXXXXXXXXX]></data> </file> </images> </files> <introvoice> <introvoices> top Bijlagetop Bijlage 1 | DebuggingOm te debuggen kunt u onderstaand div-element op een willekeurige locatie binnen de editor of player pagina plaatsen. Op deze manier wordt het e.e.a. aan informatie getoond op de website. Dit kan voor het zoeken van debug informatie erg handig zijn. <div></div> In het geval van eventuele complicatie zullen wij u verzoeken deze codes op te sturen in combinatie met de documenten waarmee u werkt en eventuele JavaScript foutmeldingen. <div id="infoWiqet"></div>
top
Bijlage 2 | Overzicht variabelenIVFormName Deze variabele wordt in het formulier weggeschreven. hierin staan 4 waardes:
top Bijlage 3 | SupportAlgemene vragen Mocht u algemene vragen hebben over de Wiqet's of over dit document, dan kunt u een email sturen naar info@wiqet.com of telefonisch contact opnemen met 020-4230500 Technische vragen Mocht u technische vragen hebben over het implemeren van een Wiqet, dan verzoeken wij een e-mail te sturen naar support@wiqet.com met daarin een zo'n duidelijk mogelijke beschrijving. Mocht er een acute technische complicatie zijn dan kunt u, bij nood, ook telefonisch contact opnemen met Sequential media 033-4625067 |
|||||
| Others in this Category | |
| Wiqet implementation document English | |
| Integrating Wiqet in your website in 6 steps. | |










