Documentation

While adding Ziggeo to Embed.ly is super easy, you might want to have more details on the same. Maybe you want to set everything the way that works best for you. We go through all the details here.

The setup can be split into several sections:

  1. Allow oEmbed to be used
  2. Embedding setup

Enabling oEmbed as well as fine tuning it to match how you want them to work is very easy. This is already described on our other page in docs, so we recommend checking it out on following page.

Now if you want to modify something, this is explained in next sections.

All embeddings on our oEmbed pages have URL override setup. This means that we have default values that would be used, unless you override them manually.

It also means that this is very easy to do through the URL part itself.

What you will need is the list of parameters that you want. On the following page you can see all of the embedding parameters.

Now we need to understand the URL patterns of our embeddings just a bit to be able to recognize what we are changing and where.

All player pages would have following URL pattern: https://ziggeo.io/p/{VIDEO_TOKEN}.

  • Notice that /p/ part of URL, and here "p" stands for player.

All recorder pages would have the following URL pattern instead: https://ziggeo.io/r/{APPLICATION_TOKEN}

  • Notice how here we have /r/ part which of course stands for recorder.

With recorder we do want to keep a lot more HTML attributes as well due to various security systems implemented by various browser vendors. You will be shown the latest in the dashboard, however here is an example:

    <iframe src="https://ziggeo.io/r/{APPLICATION_TOKEN}" frameborder='0' scrolling='no' allow='speakers *; autoplay *; fullscreen *; microphone *; camera *; usermedia *' allowspeakers allowautoplay allowfullscreen allowmicrophone allowcamera allowusermedia></iframe>

Now both players and recorders would be modified by adding URL parameters at the end of your current URL.

Lets say that you want to set the theme to be Cube and with Green color. This is how we would change the URL of the player:

https://ziggeo.io/p/{VIDEO_TOKEN}?theme=cube&themecolor=green

Now lets do the same to recorder:

https://ziggeo.io/r/{APPLICATION_TOKEN}?theme=cube&themecolor=green

As you can see the way you would change it is same for both.

That is it, all done, just add the codes into your own system.

Need a bit more details on creating the URL? See section bellow.

Above you saw all the details you need once you have your parameters. What if you never saw or edited / created URL parameters?

Well first, know that we are always here for you, so just let us know and we would be happy to assist with the same.

Now back to the parameters and URLs. All URLS allow additional parameters to be passed. You might see this as GET parameters or URL parameters.

The first URL parameter would start with a question mark (?). Question mark is followed by attribute/parameter name and then on the other side of equal sign would be the value.

This is the scheme of the same:

?[parameter1]=[value1]&[parameter2]=[value2]&[parameterN]=[valueN] ...

[parameterX] would be any parameter of your choice and likewise [valueX] would be the value that it should be set up.