====== googledrawing Plugin ======

---- plugin ----
description: Lets you paste google drawing links, and they will be shown as an image
author     : Linus Brimstedt, Michael Stewart
type       : syntax
lastupdate : 2014-05-29
compatible : Anteater, Rincewind, Angua, Adora Belle, Binky, Ponder Stibbons, Hrun, Detritus, Elenor Of Tsort, Frusterick Manners
depends    : 
conflicts  : 
similar    : 
tags       : google googledocs googledrawing images

downloadurl: https://github.com/statueofmike/googledrawing/zipball/master
bugtracker : https://github.com/statueofmike/googledrawing/issues
sourcerepo : https://github.com/statueofmike/googledrawing
donationurl: 
----


===== Installation =====

Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.

===== Examples/Usage =====

Paste the link of a published google drawing in your dokuwiki page:

  URL from editor:
  https://docs.google.com/drawings/edit?id=1j4V1jYvhZBfOqWDQ-eIsL2vA3nOI9jsNce_ACI9dAwU
  
  Old publish URL:
  https://docs.google.com/drawings/pub?id=1j4V1jYvhZBfOqWDQ-eIsL2vA3nOI9jsNce_ACI9dAwU&w=555&h=396

The plugin will convert the link to a <img>-tag displaying the image.

The image will be clickable and open the google drawing page in a new windows, so you can edit it on the fly.

This is useful for example if you want to have sketches that are as easily edited as the wiki itself: no need to upload new versions of images, etc.

You can also use a more specific syntax if you want more control

  {{gdraw>1j4V1jYvhZBfOqWDQ-eIsL2vA3nOI9jsNce_ACI9dAwU width=123 title="test title" center}}

This syntax allows you to set tile and alignment as well as width and height.

===== Demo =====

<del>http://michaeldata.net/doku.php?id=googledrawing</del>

===== Configuration and Settings =====

If you use google docs for your own domain, you can configure the domain base url.

=== Change Log ===

  * **2011-02-28**
    * Initial release
  * **2013-04-22**
    * Update for new URLs and bugfix

=== Feature Request ===
  * "New Google Image" button for editor toolbar

=== Known Bugs and Issues ===
  - The {{}} syntax may not work
  - The "specific syntax" may be incompatible with the [[plugin:mediasyntax|MediaSyntax plugin]]
  - Of course, the Google drawing has to be "published to the world". If the drawing is published for a selected set of users only - those users must be logged on to their google docs account for the image to work.