google-docs-add-on

Publish to WordPress from Google Docs

Subscribe to updates I use google-docs-add-on


Statistics on google-docs-add-on

Number of watchers on Github 108
Number of open issues 23
Average time to close an issue 24 days
Main language JavaScript
Average time to merge a PR 2 days
Open pull requests 2+
Closed pull requests 0+
Last commit over 1 year ago
Repo Created about 2 years ago
Repo Last Updated 10 months ago
Size 315 KB
Organization / Authorautomattic
Contributors3
Page Updated
Do you use google-docs-add-on? Leave a review!
View open issues (23)
View on github
Fresh, new opensource launches 🚀🚀🚀
Trendy new open source projects in your inbox! View examples

Subscribe to our mailing list

Evaluating google-docs-add-on for your project? Score Explanation
Commits Score (?)
Issues & PR Score (?)

Getting started

The add-on lives in Google's Script Editor but, in keeping with best practices, this repo is the source of truth, and the script editor will be overwritten with local changes.

Configuring

This process needs to be performed once:

  1. npm install to install all dependencies
  2. Follow the first step here: Node Google Apps Quickstart - Independent Developer Console Project is recommended.
  3. Download the JSON oAuth details
  4. ./node_modules/bin/gapps auth <PATH-TO-JSON-OAUTH-FILE> and follow instructions
  5. Edit the generated gapps.config.json file and change the value for path to be src
  6. Create a new apps script here: https://script.google.com
  7. Get the script ID from the URL (everything between the /d/ and /edit - script.google.com/a/google.com/d/SCRIPT_ID_HERE/edit)
  8. ./node_modules/bin/gapps init <SCRIPT_ID>
  9. Create a new WordPress.com App:
    1. Set the redirect URL to be https://script.google.com/macros/d/SCRIPT_ID/usercallback
    2. Make a note of the app client ID and client secret
  10. In the app script, go to File and Project Properties
    1. Select the Script properties tab
    2. Add OauthClientId and set the value to your app
    3. Add OauthClientSecret and set the value to your app

Everything is now setup.

Deploying

npm run deploy

This will use node-google-apps-script to upload the src directory to the add-on's script editor.

Testing

In the script editor choose Publish Test as add-on and then select a document to test with.

That will open a new window with your document. You will then see your project in the Add-ons menu.

google-docs-add-on open issues Ask a question     (View All Issues)
  • almost 2 years When auth window closes sometimes it doesn't go back to Google
  • almost 2 years Improve JSON API error (while authorising)
  • almost 2 years Is the reload button needed?
  • almost 2 years Improve message shown when auth is denied
  • almost 2 years Show proper error and guide if JSON API is disabled
  • almost 2 years Improve support site
  • almost 2 years Clarify initial support prompt
  • almost 2 years reopen of unable to connect Google Docs
  • almost 2 years Image Cropping
  • almost 2 years Accessibility: Authorization Screen and Google Docs Interface
  • almost 2 years Support custom post types
  • about 2 years Support REST content API
  • about 2 years Support for text alignment
  • about 2 years Full support for text-styling attributes
google-docs-add-on open pull requests (View All Pulls)
  • Add a custom JSON API template
  • WIP Add the ability to unlink a post from a document
google-docs-add-on questions on Stackoverflow (View All Questions)
  • Unable to publish Google Docs add-on after review and updating
  • call native "find" (ctrl-f) in google docs add-on
  • Publishing a Google Docs Add-on: Project Key is not associated with the current project
  • Google docs - add-on for browser
  • Getting domain installs for my Google Docs Add-on
  • Add text and remove text in Google Docs (Add-on)
  • How to debug Google Docs Add-On
  • How do you send a webhook request via a google docs add-on?
  • How to check out code from old version with Google docs add-on script
  • Passing information to server-side function in a Google Docs Add On
  • Google Docs Add-On - Dealing with Images
  • Background subsection required when publishing a translated Google Docs Add-on
  • Google Docs Add On onEdit
  • How to display "Working" toast from Google Docs add-on
  • Alternative to Alert / confirm() in Google Docs add on
  • How can I attach some data to an image in a Google Docs Add-on script?
google-docs-add-on list of languages used
Other projects in JavaScript