Maxi Blocks for WordPress plugin directory

[elzadj]

Description

A general issue with lists for a plugin version we should create for https://wordpress.org/plugins/

• - We need a readme.txt file, a.k.a the main description of the plugin. Maxi version is here: [readme.txt](https://github.com/maxi-blocks/maxi-blocprepare ks/files/11011609/readme.txt)
• - Licences and licence file - for the plugin, for our library items, everything that we use. Maybe we should check other plugins like Kadence first. As much as I can say for now - everyone uses readme.txt to state the licence and credit other devs.
• - Need to check translations, and that we did not miss anything. Need to generate .pot file and put it into the languages folder. note: Wordpress has its own translation service, example https://wordpress.org/plugins/kadence-blocks/#developers and https://translate.wordpress.org/projects/wp-plugins/kadence-blocks/, so maybe we should use it too. All in one place.
• - Need to test and fix our plugin for the latest WP version. Maxi Blocks for the latests WP versions #4475
• - Need to check the https://auth.maxiblocks.com/, and merge authorization code into our plugin.
• - https://github.com/maxi-blocks/maxi-blocks/issues/4444
• - Need some images for the assets, here is an example, they also can be [animated](https://wordpress.org/plugins/essential-blocks/ Here is a detailed manual
• - Need to decide what to do with the Crisp tracking, because this. A toggle in the dashboard "I consent to use blah blah blah"
• - Need to decide if we want to use WordPress forums for support, example YES
• - Need to create block previews https://github.com/maxi-blocks/maxi-blocks/discussions/4417
• - Version rollback (leave commented out code, but remove all mentions of Jetpack plugin)
• - Bunny CDN for images. @ckp267 I'm Manually rewriting urls at the moment. We should set bunny up on devdemo.maxiblocks.com
• Prepare the assets folder https://developer.wordpress.org/plugins/wordpress-org/plugin-assets/
  Example: https://plugins.svn.wordpress.org/conditional-blocks/assets/
• Hide Connect to account button, make sure all the Go Pro button lead to the subscribe page, not to the pricing page
• Need a source code version with all potentially sensitive info removed
• Need a public repo for the version above

Later:

• - Auth UI + fixes + code improvements
• - Need to deal with expired subs

Other plugins or websites examples

https://wordpress.org/plugins/kadence-blocks/
https://wordpress.org/plugins/ultimate-addons-for-gutenberg/
https://wordpress.org/plugins/ultimate-blocks/
https://wordpress.org/plugins/essential-blocks/
https://wordpress.org/plugins/stackable-ultimate-gutenberg-blocks/

basically everything in https://wordpress.org/plugins/

How to implement it

With a lot of coffee

Other information

Useful readings:

How to Add Your Plugin to the WordPress Plugin Directory
Detailed Plugin Guidelines
Block Specific Plugin Guidelines
Plugin Developer FAQ
Forum guidelines
How the readme file works
Using Subversion

[elzadj]

A list of external scripts that we are using inside. (italic is for items that we don't want to include into the first version, buuut we include them later anyway)

• Crisp crisp-sdk-web https://github.com/crisp-im/crisp-sdk-web
• Video Maxi - vimeo.com https://player.vimeo.com/api/player.js
• Video Maxi - YT https://www.youtube.com/iframe_api, ttps://www.youtube.com/embed/
• Video Maxi - Default video https://www.youtube.com/watch?v=ScMzIvxBSi4
• Google Font API https://fonts.googleapis.com/css2?family=Roboto (and others)
  Licence https://developers.google.com/fonts/faq#can_i_use_any_font_in_a_commercial_product
• Google fonts from https://fonts.gstatic.com (like https://fonts.gstatic.com/s/roboto/v20/KFOkCnqEu92Fr1MmgWxPKTM1K9nz.ttf)
• Google fonts json from https://github.com/jonathantneal/google-fonts-complete
• Using some code from https://stackoverflow.com/a/71006998
• Using code from https://github.com/WordPress/gutenberg/blob/3cbfa27165c8089a9403985bc9ee7698c93b08a8/packages/components/src/base-control/index.js
• Using code from https://github.com/WordPress/gutenberg/blob/release/13.9/packages/components/src/popover/index.js
• Code from https://usehooks-ts.com/react-hook/use-interval
• Code from Children prop gets recreated killing PureComponent optimizations facebook/react#8669 (comment)
• Code from https://github.com/WordPress/gutenberg/blob/7c467c773b7c391bfe40281a39ac5630688e3437/packages/rich-text/
• A link in comments to https://floating-ui.com/docs/virtual-elements (to explain some code)
• Open streets map https://nominatim.openstreetmap.org/search?q=London&format=json
• Open street maps tile.openstreetmap.org
• Google Maps https://maps.googleapis.com/maps/api/js

[elzadj]

A command to generate a .pot file: wp i18n make-pot . languages/maxi-blocks.pot --slug=maxi-blocks
Need https://make.wordpress.org/cli/handbook/guides/installing/

[elzadj]

Ok, so the translation services:

1. PoEdit site - no contextual screenshots or whatever, it's possible to pay for translations. Also there is an option for auto-translation, but it's free for only 10000 characters, and ours has 12000+ characters, so I can't even test it for free.
2. PoEdit plugin - no context too, it can synchronize the local translation files with remote, and the other way around. You need an API key for it, so need to have an account on the poedit site
3. translate.wordpress.org - open source, no paid or automated translations. Interface looks older than poedit, but mostly the same. Need a WP account to contribute. A default one for all WP directory plugins.

I think we should use translate.wordpress.org for our outside contributors (for free). If we want to pay or create automated one, we can use poeditor site.

[kyrapieterse]

ok lets do it. Free got my vote.

[elzadj]

We need a testing pricing table, it was on https://staging.maxiblocks.com/pricing before, but I guess we removed it.
And update to provisioning team accounts by default on appwrite.

[elzadj]

Ok, I have several questions:

1. Where do we want our future pricing / checkout? maxiblocks.com/pricing ? Asking, because I need to re-integrate stripe / appwrite into the current theme. Answer: https://maxiblocks.com/go/pricing
2. Do we need Teams (real teams for 2+ members) to work before we go to the WP directory? (not sure here - if we do want it, we need to add a big part for user management to my.maxiblocks.com) Answer: NO
3. Do we need a single (a team for one member aka owner) to work before we go to the WP directory? (I think that yes, we need it working, and I'm probing code for it now, need to limit the users per team, etc). Answer: no need for a team for a single user
4. Can I see a wireframe for the pricing page? No need for a psd yet, just a wireframe or a description of what you want to show there. Answer: just use a button that opens a stripe checkout

[elzadj]

Bugs noticed on my.maxi and checkout:

1. Stripe does not redirect to my.maxi after a successful checkout
2. the user info does not show on my.maxi after using a magic link, need to hard-refresh the site + ML shows a 500 error.

[elzadj]

Not sure if that header is ok, looks a little bit weird

[kyrapieterse]

going to be working on the UI in the next few days

[elzadj]

@ckp267 I've added a toggle for the Crisp chat, please advise on the text for the dashboard. Here is what we have for now:

'Readt more about Crisp tracking' links to https://help.crisp.chat/en/article/whats-crisp-eu-gdpr-compliance-status-nhv54c/

I also linked all the "?" buttons to https://maxiblocks.com/go/help-center when the Crisp is disabled. Not sure what else we can do here.

You can test in the branch wp-directory

Here is a video:

screencast-bpconcjcammlapcogcnnelfmaeghhagj-2023.03.15-15_55_28.webm

[ckp267]

'Readt more about Crisp tracking' links to https://help.crisp.chat/en/article/whats-crisp-eu-gdpr-compliance-status-nhv54c/

This is great. Update text as follows.

Enable live chat support (temporary)
For a short time we're offering live chat to help troubleshoot issues during the beta plugin release. Live chat will be removed in a future update. By activating this option you agree to the GDPR terms as set out in the Crisp chat service terms.
Read about Crisp GDPR terms https://help.crisp.chat/en/article/whats-crisp-eu-gdpr-compliance-status-nhv54c/

Read about Crisp GDPR terms (is anchor link text)

@elzadj

[elzadj]

I have some question about the WP directory version:

1. What should we do with the Beta thing (we now allow people to download Pro items if they have the "beta" tag). Should we just remove it from the WP directory version?
2. What to do with the plugin UI for the users who have a failed payment, or a cancelled sub? They are basically in a Free mode (can't download Pro because the sub is not active), but they are still logged in, and they have an account. Should we show somehow that the pro sub is not active? We can add a button "manage sub" that leads them to Stripe in case they want to try to pay again or continue the sub.
   

I mean, if a user can't download Pro items, but is logged in at the same time, like on the screenshot above, and we show nothing about what is going on, this is confusing. User doesn't know what to do.

[elzadj]

3. I don't know how to deal with possible multiply subscriptions per one customer (email). Ideally, we need to restrict it to "1 customer 1 active sub", but it's not possible with Stripe settings, and other ways are nightmarish https://stackoverflow.com/a/67424247

[ckp267]

1. What should we do with the Beta thing (we now allow people to download Pro items if they have the "beta" tag). Should we just remove it from the WP directory version?

Keep download Pro items if they have the "beta" tag for all versions of MB plugin. We will remove/add "beta" tag by hand when we don't want to show them.

2. What to do with the plugin UI for the users who have a failed payment, or a cancelled sub? They are basically in a Free mode (can't download Pro because the sub is not active), but they are still logged in, and they have an account. Should we show somehow that the pro sub is not active? We can add a button "manage sub" that leads them to Stripe in case they want to try to pay again or continue the sub.

@kyrapieterse will update the Library modal UI to make it very clear when Pro library is active.

1. Need to add [Account] button link to my.maxiblocks.com in modal header
2. Subscriptions have different states and UI or buttons need to show that state. Allow creators to act on it.
3. States are

• active > Pro is active - user can insert all pro templates if logged in, show [my account] + [sign out] buttons
• past_due > renewal waiting for payment [Renew Pro] > link to my.maxiblocks.com
• unpaid > Renewal failed [Renew Pro] > link to my.maxiblocks.com
• canceled > no active sub, canceled, still have user account show [Renew Pro] > link to my.maxiblocks.com
• incomplete > NOT USED
• incomplete_expired > NOT USED
• trialing > NOT USED at the moment - might add in future - not sure
• paused > NOT USED at the moment

Logged out - swap [Insert] for [Join pro] button and show [Sign in] top right in lib ui modal.

I mean, if a user can't download Pro items, but is logged in at the same time, like on the screenshot above, and we show nothing about what is going on, this is confusing. User doesn't know what to do.

I don't know how to deal with possible multiply subscriptions per one customer (email). Ideally, we need to restrict it to "1 customer 1 active sub", but it's not possible with Stripe settings, and other ways are nightmarish https://stackoverflow.com/a/67424247

As discussed with @elzadj this i tricky one we need to figure out. It should become easier when we add "seats" because then extra members will be cheaper. Need to prompt people to sign in if they have an account BEFORE they buy again.
Once logged in on my.maxiblocks.com we can show them – you have x subscriptions already - add seats here... or something like this.