Opt-in Usage Tracking in Gutenberg

Starting in last Friday’s version 0.7.0, the GutenbergGutenberg The Gutenberg project is the new Editor Interface for WordPress. The editor improves the process and experience of creating new content, making writing rich content much simpler. It uses ‘blocks’ to add richness rather than shortcodes, custom HTML etc. https://wordpress.org/gutenberg/ pluginPlugin A plugin is a piece of software containing a group of functions that can be added to a WordPress website. They can extend functionality or add new features to your WordPress websites. WordPress plugins are written in the PHP programming language and integrate seamlessly with WordPress. These can be free in the WordPress.org Plugin Directory https://wordpress.org/plugins/ or can be cost-based plugin from a third-party contains a mechanism to count how often specific actions occur over time.  Before anything is tracked, each WordPress user on each site must opt in to the tracking via an opt-in screen shown when loading the new version of the plugin.  Here is what that screen looks like:

Whether a user clicks “Yes” or “No”, this preference is remembered as a user option.

If the user has previously clicked “Yes” on this screen, and an event occurs that has an associated bumpStat call in the Gutenberg code, then this event is sent to WordPress.comWordPress.com An online implementation of WordPress code that lets you immediately access a new WordPress environment to publish your content. WordPress.com is a private company owned by Automattic that hosts the largest multisite in the world. This is arguably the best place to start blogging if you have never touched WordPress before. https://wordpress.com/ servers by loading a special “pixel” image.  The following data is stored for future analysis:

  • The “group” and “name” sent with the bumpStat call (short strings of text)
  • The time the event was recorded.

We’ll use this data to look at usage patterns and make the editor experience better over time.

As Gutenberg is an open-source community project, we view this data as belonging to the WordPress community, so we also plan to make this data available via a public dashboard.  In the meantime, here is a preview of the number and type of blocks added to posts in the editor over the few days since the 0.7.0 release:

Finally, for more details about the technical implementation of this feature, see the GitHubGitHub GitHub is a website that offers online implementation of git repositories that can easily be shared, copied and modified by other developers. Public repositories are free to host, private repositories require a paid subscription. GitHub introduced the concept of the ‘pull request’ where code changes done in branches by contributors can be reviewed and discussed before being merged be the repository owner. https://github.com/ pull requests where it was developed:  2140, 2205, and 2217.

#gutenberg