When opening Add-ons > WordPress.com for Google Docs > Help > Report an issue in the pop-up there, it links to support.wordpress.com.

They can't find the docs for the addon there as that is on https://apps.wordpress.com/google-docs/, but if the link is to report an issue, I'd suggest that they either get pointed to:

• https://github.com/Automattic/google-docs-add-on/issues/new
• or: https://chrome.google.com/webstore/detail/wordpresscom-for-google-d/baibkfjlahbcogbckhjljjenalhamjbp
• or directly to: wordpress.com/help/contact

There are two other places that they end up on wordpress.com/help where I couldn't find a single doc about this:

• The bottom right question mark in the docs window:
• The add-ons page on the webstore:

I'd like to add an accordion or drawer under each site with extra fields e.g. categories, tags, custom post type, post status, and the delete site button.

This would address the a11y issue with delete site in #31 and offer a UI for the custom post types in #27

@jasmussen can you take a stab at this based on the add/react branch?

TODO:

• detect text is being pasted from gdocs. See demo (a picture will be shown if text is pasted from gdocs).
• implement a first notice in calypso
• iterate and ship it
• show the tour in production. Either add the flag "guided-tours/gdocs-integration-tour": true to production config or remove the isEnabled check.
• make the landing page visible for non proxied users - cc @georgeh

I tried to add a draft and got the following error:

{"message":"Request failed for https://public-api.wordpress.com/rest/v1.1/sites/38783427/media/new returned code 400. Truncated server response: {"error":"unsupported_mime_type","message":"File type unknown"} (use muteHttpExceptions option to examine full response).","name":"Exception","fileName":"Code (WordPress.com for Google Docs)","lineNumber":3280,"stack":"\tat Code (WordPress.com for Google Docs):3280 (request)\n\tat Code (WordPress.com for Google Docs):3292 (post)\n\tat Code (WordPress.com for Google Docs):3344 (uploadImage)\n\tat Code (WordPress.com for Google Docs):248 (upload)\n\tat Code (WordPress.com for Google Docs):3951\n\tat Code (WordPress.com for Google Docs):3737 (renderInlineImage)\n\tat Code (WordPress.com for Google Docs):3491 (renderElement)\n\tat Code (WordPress.com for Google Docs):3476 (renderContainer)\n\tat Code (WordPress.com for Google Docs):3551 (renderParagraph)\n\tat Code (WordPress.com for Google Docs):3487 (renderElement)\n\tat Code (WordPress.com for Google Docs):3476 (renderContainer)\n\tat Code (WordPress.com for Google Docs):253 (postToWordPress)\n"}

I was using quite a few photos in a long post (13 pages in Docs including the pics).

It worked really nicely with one image so I went a bit mad!

Steps to reproduce:

1. Insert -> Image -> By URL (this preserves the filename)
2. Put in a URL with an unsupported character
   • + is known bad, there are probably others
   • https://george.hotelling.net/images/9Cze+.jpg can work as a test file
3. Save draft

What actually happens:

• An alert is displayed with an error saying "File is empty. Please upload something more substantial"
• The image is not uploaded
• The draft has an empty image tag

Test document: https://docs.google.com/document/d/1ah1ClnNfy02mlXcnSPp3P7gm_PMta1q5tAsi-gu_OYM/edit

When the add on is first installed you are shown this prompt:

I wasn't sure where 'open' was (and missed the little arrow thing), and it was only after digging about the menus I found it in the Add On menu.

I think it's worth changing this prompt to clarify exactly what you need to do (preferably with a picture).

• Click the 'Add on' menu
• Go to WordPress.com for Google Docs
• Click 'Open' from the submenu

When attempting to connect to Jetpack sites, some users are getting this error on connect:

"Someone may be trying to trick you into giving them access to your site. Or it could be you just encountered a bug :). Either way, please close this window."

Possibly related to Automattic/jetpack#5847

Moving here from our internal blog.

Had a user contact us (who is blind) in 3098158-t who is having trouble authorizing their Jetpack site because it’s not apparent that there’s a drop down:

While we’re visually prompted that it is a drop down, to her it’s not apparent as the down arrow isn’t accessible via keyboard. Even walking her through the steps in great detail using only my keyboard, she’s not able to select her Jetpack site since it’s not the first site in her list.

Additionally, in the list of sites in Google docs – there’s no way to remove a site once it’s been added unless you use a mouse hover:

Testing for screen reader devices would be the first step in relieving these pain points for visually impaired users.

If you mark text as bold or italic, within a list, then it is formatted as a list, but the bold/italics don't carry across.

I have an 502 Bad Gateway error from Nginx.
Why?

If you try to add a site and then deny access you end up on this page:

I don't know if we can run any code on this page, but if we can then we should detect the specific problem and show something more appropriate. The error is contained in the URL:

error=access_denied&error_description=You+need+to+log+in+to+WordPress.com

After saving a draft successfully from google docs, I wanted to see the draft, as I was testing. So I opened wp.com, etc.

I was wondering whether in future releases of overpass we could hint the draft URL to the user after confirmation. As an example of what I mean, it could be kind of the same micro-interaction that we have in dotcom after publishing a post (see view post link).

The new REST content API in 4.7 would allow non-Jetpack users to use this add-on.

The biggest challenges right now are authentication and UX. Oauth tokens are better than app-specific passwords are better than standard passwords. The nice thing about the Jetpack API is that we can send folks to a single URL that lists all of their connected sites.

To support all .org sites, we will have to have them enter the URL for the site and then do a check to see what kind of authentication is available.

When putting in images, if they are set as "Wrap Text" or "Break Text" they don't correctly sync with Google Images.

To reproduce:

1. Create new Google Doc and authenticate with a site.
2. Insert an image.
3. Publish as a draft.
4. Observe image in WP.
5. In Google Docs, set image to "Wrap Text" or "Break Text" and publish draft.
6. Observe image in WP.

Expected result: Image is there and wrapped appropriately.

Current result: Image is not there.

The support link in the bottom right corner of Google Docs takes you to https://wordpress.com/help instead of https://apps.wordpress.com/support/#faq-googledocs-1

Hi,
I had tagged onto another persons issue. Bad me! Anyway, I can't connect my Google Docs to the site http://www.robertmeans.net. At first it was that I didn't have the API on. Now that the API is on I get the error message that the site does not seem to be accessible or no longer has jetpack installed. Both of which are not true. I went through the troubleshooting tips and my xmlrpc.php is correct. Any other ideas?
Thanks,
Bob

If you have the JSON API disabled in Jetpack and you try and save to draft you get this at the bottom of the add on window:

Instead we should show a proper error and maybe detect this specific case and explain how to fix it / link to a support page specifically for this.

Note: I disabled the JSON API after authorizing the connection

When connecting to a Jetpack site you end up with a very long URL that on some servers can overflow the maximum header size leading to a 502 server error.

See #65, and also happens on my own server. Seems to affect Nginx more, maybe due to smaller default settings.

Steps to reproduce:

1. Add a Jetpack site
2. Note the long length of the URL

Looking into this URL we have this:

Array
(
    [action] => jetpack_json_api_authorization
    [redirect_to] => <REDIRECT>
    [data] => <LONG STRING>
    [token] => <TOKEN>
    [timestamp] => 1490859498
    [nonce] => <NONCE>
    [body-hash] =>
    [signature] => <SIGNATURE>
)

So far so good. Breaking the redirect_to down further we have:

Array
(
    [0] => client_id=1234
    [1] => response_type=code
    [2] => redirect_uri=<URL TO GOOGLE DOCS ADD ON>
    [3] => state=<STATE>
    [4] => action=oauth2-login
    [5] => redirect_to=https://public-api.wordpress.com/oauth2/authorize/?client_id=1234
    [6] => response_type=code
    [7] => redirect_uri=<ENCODED URL TO GOOGLE DOCS ADD ON>
    [8] => state=<STATE>
    [9] => jetpack-code
    [10] => jetpack-user-id=0
    [11] => action=oauth2-login
    [12] => blog_id=<BLOGID>
    [13] => _wpnonce=<NONCE>
)

Note how redirect_uri, state, action, and response_type are specified twice (with the second redirect_uri being double encoded). Because of how PHP's parse_str works only the first value will be used.

The state variable in particular is very long and all told can add up to > 1700 bytes.

At the moment I'm not sure whether the problem is in the add-on, Jetpack, or even WordPress (.com or .org). I'll try and work through the flow. Any additional insights would be appreciated.

Figure out what we want to track and how we want to track it.

Feedback from @kriskarkoski

I think making Authorize a button would make it more obvious and a refresh option would be nice if feasible. If not changing the language to instructions of closing and reopening from add ons would be better

tagging @jasmussen

I have a blog on Wordpress.com and another one outside using Jetpack plugin fully working but I can't to Authorize. I can select from the combo box but after that I recive a message, is in Spanish in my case:

Alguien puede estar tratando de engañarlo para que le de acceso a su sitio. O simplemente puede haber encontrado un error :). De cualquier manera, por favor cierre esta ventana.
http://myblog-URL/wp-login.php?action=jetpack_json_api_authorization&redirect_to=...

User in 3110157-t is getting a 502 Bad Gateway error when attempting to connect:

Hi, im trying to connect my google account to wordpress, after having installed the addon:

I select the blog with jetpack installed and click approve:

I get this 502 bad gateway error:

I'm logged in just fine into the blog with the wordpress.com user:

What can be wrong?

If you try and authorise a Jetpack blog without the JSON API enabled you get this:

I think a lot of users will experience this particular error so we should make it as informative as possible.

• Add a bit of style / imagery to the error page - a sad face, a sad robot etc
• More descriptive error ('there was a problem' is a bit opaque)
• Show an image of the JSON API setting
• Link to our support page for this
• Remove the exception and, if possible, just show the error and message

User in Livechat reported today that any time she clicks away from her main page (upon which is a Google form) she gets a dialogue box

Steps to reproduce:

1. Create a Google form.
2. Embed form in page or post.
3. Load the page.
4. Click any link away from the post or page where the form is embedded, or try to close the page.

Expected:
5. Leave the page or exit out of the page, no dialogue box.

Actual:
5. A dialogue box will appear, asking if you want to 'save your changes'.

Also seen here on published page:

If a user submits the Google form and tries to leave, there is no longer a dialogue box that appears when someone tries to leave the page.

Only an issue in Chrome and Opera. Does not create this dialogue box in Safari or Firefox.

Reported in #3108947-t

The word "Links" in https://teamtinker.wordpress.com/2016/12/15/project-overpass-call-for-alpha-testers/ should be a link

Steps to reproduce:

• Install staging add-on
• Confirm that "Overpass" menu includes "Open"
• Close document and open another

What happens: Overpass menu is missing "Open" item

What should happen: Overpass remains installed for all docs

An animated GIF in a document will not show up as animated. Instead, it will only display the first frame of the animation.

I was unable to test the "Authorize", as I was already authorized. When I disconnected the Overpass oauth application in my security settings, when I tested the next time I got this error message:

This stopped me from being able to test further — I'd been hoping it would ask me to re-auth.

Steps to reproduce:

1. Open the add-on in MS Edge (tested Edge 14.14393)
2. Click the "Add WordPress Site" button at the bottom

What I expected: The WordPress.com site chooser to open in a new tab.

What happened: Nothing.

Likely due to pop-up blocking.

Every time a draft is saved, the image is uploaded, creating duplicates. If there's no change to the image, the existing image in the media library should be used.

If you have a multi-level list, they are collapsed down to a single/top-level list

If updating an existing post, warn that we will overwrite any changes made via WordPress.com or other editors. Possibly check the timestamp and see if someone has edited since last upload before triggering the message

I'm not actually sure how it should be represented within WP (h1?) but if you format text as "Title" in Google Docs, it comes across just as a normal paragraph.

• FONT_SIZE
• ITALIC
• STRIKETHROUGH
• FOREGROUND_COLOR
• BOLD
• LINK_URL
• UNDERLINE
• FONT_FAMILY
• BACKGROUND_COLOR

With no sites you are shown this message:

In my testing the reload button is not needed - the site always appears automatically anyway. If it's not needed we should remove it.

Allows sites to enumerate post types that Google Docs can write to. Similar to rest_api_allowed_post_types.

Steps to reproduce:

1. Add an image to a document
2. Right click on the image, choose "Crop Image", and adjust size
3. Save draft to site

What I expect to happen:

The image in WordPress is cropped to match the document.

What actually happens:

The original, uncropped image is uploaded.

When you first go to the support page you see this:

The Google Docs title is half hidden, and you see 'WP for iOS', which is confusing.

I think we need to split the apps.wordpress.com support pages out into separate pages, and include screenshots and a video.

When attempting to add a drawing:

It fails to get exported to WordPress, and instead shows some INLINE_DRAWING: InlineDrawing placeholder content. Google Docs on left, WordPress draft on right:

It would be ideal if they could be exported as SVGs.

Allow a user to authorize multiple sites and select which one to save to.

Hello,

I have a number of wordpress.com sites on this account, plus personally hosted wordpress sites using the Jetpack plugin. I am excited about this add-on and want to use it for most of my sites.

However, I just installed the google-docs-add-on, but only seed2sow.wordpress.com shows up on the side panel of the Google docs page. Can you help?

Thanks.

Jeanette Burton

It's a great add-on and I personally love being able to decouple from the editor and write from a more natural one, but It appears that footnotes are not currently supported. That would be a wonderful feature for those of us who use footnotes.

I can't reproduce this properly yet, but a few times I've authorised a connection and the WP auth tab closes and I don't end up on Google Docs.

Detailing here as WIP.

Right now, if you publish a post and then update it from the add-on, you will be warned that you are overwriting what is on the server. If you say OK to the modal, you will update and un-publish. A couple folks have mentioned that's not what they would expect.

Two ideas to explore:

1. Creating the update as a Revision post type
   • How would this work with the preview link?
   • How would this interact with Custom Post Types in the future? ( #27 )
2. Updating the post but leaving the status set as Published

We should still keep the warning modal either way.