search

Good-Bids / goodbids

0 stars 0 forks source link

[Troubleshoot] Jetpack Plugin #704

Closed clatwell closed 7 months ago

clatwell commented 8 months ago

This is something that's been on my list for a while and I could use a second set of eyes to help figure out what we want to do.

Here's what I know

Image

Here's what we want

What do we need to do?

linear[bot] commented 8 months ago
GOO-260 [Troubleshoot] Jetpack Plugin

This is something that's been on my list for a while and I could use a second set of eyes to help figure out what we want to do. ### Here's what I know * WPVIP sites ship with the Jetpack plugin enabled, and it's compatible with multi-site * [Network Admin: Jetpack / Sites](https://staging.goodbids.org/wp-admin/network/admin.php?page=jetpack) * [Network Admin: Jetpack / Settings ](https://staging.goodbids.org/wp-admin/network/admin.php?page=jetpack-settings) * To use Jetpack, the site needs to be connected to [WordPress.com](http://WordPress.com) * Currently the GOODBIDS main site is connected to my [WordPress.com](http://WordPress.com) account; but you can update to yours for testing. * Jetpack tracks some basic stats (# of visitors, views, etc.) and insights. * Note: These should be pulling into the Jetpack Dashboard, but I'm seeing a "Something happened while loading Jetpack Stats" error on the GOODBIDS main site and all the Nonprofit sites, although I can see these stats on [WordPress.com](http://WordPress.com) * The GOODBIDS main site is using Jetpack's form builder feature for the Nonprofit Inquiry Form and the Report an Issue form; these seem to be working great. * Seemingly, for a Nonprofit Site to be able to use Jetpack, the connection has to be enabled on the Network Admin level, even though I've enabled the "Allow individual site administrators to manage their own connections" settings in Network Admin > Jetpack > Settings. * I created the Marbles Kids Museum site with my `clairebdpadmin` account, so this account is the Site Administrator. However, I'm still seeing this message on the Jetpack dashboard: [Image](https://uploads.linear.app/c5f89e46-a242-4cc9-bea3-c8c2a1cb48f1/6cac6f81-4aa3-4ba2-87c1-ff207c94bd7b/b366d348-e9b0-4c44-b565-af554b33fd31) ### Here's what we want * When we launch to production, Jasper should connect Jetpack for the GB Main Site to [WordPress.com](http://WordPress.com) using his account * We should see stats on the Jetpack Dashboard for the GB Main Site * Nonprofit Site Administrators should be able to connect *their own accounts* to [WordPress.com](http://WordPress.com) to enable Jetpack for their Sites. * We should see stats on the Jetpack Dashboard for any Nonprofit Site that has connected their account. ### What do we need to do? * Steven test to see if you're able to connect a NP site to Jetpack using your [WordPress.com](http://WordPress.com) account -- I'm wondering if one of the issues right now is that all the Connected sites are Connected using my account * It might make sense to reach out to WPVIP to verify the expected behavior for Jetpack and flag the issues we're seeing: * Jetpack Stats aren't displaying on the Dashboard for connected sites. * Site Administrators aren't able to connect their own sites to [WordPress.com](http://WordPress.com) * When we go to production, have Jasper connect the GOODBIDS Main Site to Jetpack via his [WordPress.com](http://WordPress.com) account * Once we have a better understanding from WPVIP of how this needs to work (so that Jetpack can be connected for Nonprofit Sites and Stats are showing up on the Dashboard), either: * Have all Nonprofit Sites connect to Jetpack via Jasper's account, and enable the connection when the site is created (like we may need to do for SSO); or, * Add content to the Nonprofit Site Guide instructing Site Administrators to connect their account to [WordPress.com](http://WordPress.com) to enable Jetpack; or, * If there's a bug here with WPVIP's setup that is going to prevent Nonprofit Sites from taking advantage of Jetpack, we need to hide it from the side navigation + remove the Jetpack form blocks so there's no confusion

shascher commented 8 months ago

Okay @clatwell - This is about as far as I can get with the current unknowns still as outliers.

Open Questions:

  1. What roles do we want Jetpack Stats to be viewed by? - Administrator, BDP Administrator, ? - I'm not sure if every admin added to the site will be able to see the Stats if they are not the administrator connected to Jetpack.

Admins Setting Up and Connecting to Jetpack

Site Administrators can connect Jetpack to their Wordpress.com account.

  1. Once logged in, Navigate to Jetpack in the sidebar
  2. Click Set up Jetpack
  3. Sign in with your Wordpress.com account, or create a new account to sign in.
  4. Click Approve
  5. On the Jetpack Plans page, select the Stats add on, or scroll to the bottom and click "Start with Jetpack Free".

Stats on Network Sites:

Jetpack’s free features are compatible with WordPress Multisite networks. Paid features also work with Multisite networks, but each site requires its own subscription.

Non-commercial sites can use Jetpack Stats for free. Commercial sites require a paid plan, which comes with priority support and access to advanced features.

How is a commercial site defined?

We define a commercial site as one that you aim to make money from. This could be through advertising or affiliate links, selling products or services, soliciting donations or sponsorships, or any other means directly related to a for-profit business or educational organization. If your site has any of these, you will need a paid Jetpack Stats plan.

Pricing for jetpack Stats for a commercial site is around $8/month billed yearly for 10k views a month. That price slides to $16.67/month billed yearly for 100k views a month.

Based on the above, I do not believe there is a path forward for Nonprofit Sites to view Jetpack Stats unless:

An alternative path would be to allow for a Nonprofit to connect their Google Analytics account to the Nonprofit Site.

Stats Page in WP Admin not loading:

@shascher has sent out a support ticket to WPVIP to check if there are any known issues with Jetpack loading data within the WP Admin and to see if they have any suggestions or input before completing further debugging.

This is the list of steps that Jetpack recommends when you have a My stats page is not loading, or showing a white page:

  1. Additional way to view stats is at: https://jetpack.com/redirect/?source=calypso-stats-insights&site=staging.goodbids.org (unsure if this URL will be the exact same on Production)
  2. Clearing browser cache is recommended by Jetpack - did not work for me
  3. Make sure you are on the most updated version of WordPress and Jetpack
    • WP Version 6.4.3 (current), Jetpack Version 13.1.3 -> 13.2.1 (current)
    • Maybe updating Jetpack would be something to try here as it is behind the current version.
  4. Disconnect and reconnect Jetpack - did not work for me
  5. Check for a plugin conflict - Some Known Issues
    • This could be a bit of finding a needle in a haystack situation if any of our MU plugins or other functional plugins are conflicting with Jetpack for loading in stats.
shascher commented 8 months ago

@clatwell - Update here from WPVIP is that:

Jetpack connection is showing some inconsistencies compared to a regular WordPress VIP Jetpack connection; the primary user is marked for claireeisinger instead of our default wpcomvip machine user which could be affecting your connection.

I've followed up to inquire about