Drupal Integration
How to add Ziggeo to Drupal
There are few simple steps to follow.
- You would start by installing the module which you would then activate.
- Once this is done you would modify or create few pages where Ziggeo embeddings would be presented
All of this is explained in detail in the sections bellow.
Installing the Ziggeo module
To install the module you should:
- As per Drupal recommendations, put your website into maintenance mode
- Install the "Libraries API" module (if you do not have it installed already);
- download the Ziggeo PHP SDK from our GitHub repository to your website
- This is the direct link if you are not familiar with GitHub: https://github.com/Ziggeo/ZiggeoPhpSdk/archive/master.zip
- The downloaded SDK zip file should be unpacted/unziped and placed into
/sites/all/libraries/
folder on your server.
- Make sure the path to the Ziggeo.php file becomes:
sites/all/libraries/ZiggeoPhpSdk/Ziggeo.php
.
- (ONLY APPLIES IF YOU ARE UPDATING) Delete the files in your current Ziggeo module folder
- Download the new module files from Drupal project page and place them in the (now) empty Ziggeo module folder
- if you are installing the module, you would need to create "Ziggeo" folder
- (this will usually be "sites/all/modules/").
- Please don't install your module in Drupal core's "modules" folder, since that will cause problems as is bad practice in general and as such if "sites/all/modules" doesn't exist yet, just create it.
- Run
update.php
file in your Drupal, or doFlush Cache
from the same. - If your website is still in maintenance mode, place it as live.
Once you do this, you should be good to go and Ziggeo module should be ready.
Enabling the Ziggeo module
On your Drupal site:
- Click on "Modules" menu at the top of the screen - in the "admin" menu.
- In the new screen that opens, find the section "Fields" and under it you should see "Ziggeo" - check it.
- Click on the Save Configuration button to activate it.
- You should see the notification about the configuration being saved properly: "The configuration options have been saved."
Adding Ziggeo pages as new content-type
- Click on "Structure" menu at the top of the screen.
- Click on "Content types".
- Here you can add Ziggeo to existing content types or to add new content type that would have Ziggeo within it only. For most setups, we will describe adding it to existing and default ("article" and "page") content types.
- Click on "manage fields" option under OPERATIONS section.
- To add new field, you should add its name in the textbox under "Add new field" label.
- Now select the "Ziggeo Field" field on the right under FIELD TYPE section. (* In the WIDGET section you will right away see "Ziggeo Recorder" being selected)
- Click on the "Save" button.
- You will now be asked for Application Token, Private Key and Encryption Key which you can get from the Overview page of your application within your Ziggeo account, and once you add it, click on "Save field settings".
Behavior settings
- Once you finish adding the field to content type, you will be presented a new page where you can make some modifications.
- Widget type allows you to set if the embedding will be recorder, uploader or both recorder and uploader (default).
- If you have any changes that you wish to make, make them and then remember to click on "Save Settings" button at the bottom.
Formatting the layout
- Click on "Structure" menu at the top of the screen.
- Click on "Content types".
- Click on "manage display" of the same content type that you had added Ziggeo field to.
- Find the Ziggeo field.
- Once you have done the changes you wanted, be sure to click on "Save" button at the bottom.
Adding Ziggeo's Recorder / Uploader / Player to a Page
- Go to "Content" menu.
- Click on the "Add content" sub menu.
- Now click on the type of the page that you had added Ziggeo field to.
- Create your page and save it.