Platform and Tooling Updates: VIP-CLI, Enterprise Search, and Content Distribution

This week, we’re announcing new self-service import capabilities, developer tools for Enterprise Search, and a change to content privacy on non-production sites. Read on for the latest updates to the VIP platform:

New VIP-CLI Release

A new release of VIP-CLI, 2.0.8 is now available.

We’ve added a beta edition of our new self-service media import tool, allowing you to bulk-import images to your WordPress applications and expanded availability of our SQL import self-service tooling, which is now available for both launched and unlaunched sites, making it easier to prepare your content for launch.

You can view more changes in the full changelog on GitHub.

 

How do I update?

To get this update, you can run the following:

npm install -g @automattic/vip

If you haven’t previously used VIP-CLI, you can start with our installation instructions.

Enterprise Search Service

VIP’s Enterprise Search service is now available, including Search Developer Tools that allow you to test search queries and confirm results. 

Enterprise Search is an out-of-the-box search configuration designed from the ground up to meet enterprise scale. Powered by Elasticsearch and our globally distributed network, Enterprise Search is a stable, secure, and performant search solution that brings the power of the Elasticsearch to the enterprise WordPress context, allowing our customers to provide modern, fast search experiences as well as a performance-enhancing layer to existing WordPress searches and queries.

Jetpack Content Distribution Set to Private on Non-Production Sites by Default 

As of today, all non-production sites are set to private Jetpack connections by default, preventing non-production site content from being accidentally indexed and searchable online. These settings can be controlled by setting a constant in your code – read more about Jetpack content distribution

We’re hard at work on further improvements and hope to have more soon. In the meantime, if you’d like to discuss your VIP developer experience or want to help test upcoming releases, please get in touch.

 

New Release: VIP-CLI 2.0

We’re excited to announce the release of VIP-CLI v2.0. The headline feature for this release is the new SQL Import command, which allows you to perform self-service imports of SQL databases to unlaunched sites.

This new SQL Import command allows you to import data to your VIP apps on your own schedule, allowing for faster and more flexible launching of new apps.

Future releases will support self-service importing of SQL databases to launched, multisite instances, as well as self-service media library imports. You can read more about migrating content to WordPress VIP in our documentation.

The VIP-CLI is a tool for developers to interact with applications hosted on the VIP Go platform via the command line. This release also deprecates support for Node 8.0, which has reached end of life.

You can view more changes in the full changelog on GitHub.

How do I update?

To get this update, you can run the following:

npm install -g @automattic/vip

If you haven’t previously used VIP-CLI, you can start with our installation instructions.

We’re hard at work on further improvements and hope to have more soon. In the meantime, if you’d like to discuss your VIP developer experience or want to help test upcoming releases, please get in touch.

New Release: VIP-CLI 1.12

We’re excited to announce the release of VIP-CLI v1.12.

The VIP-CLI is a tool for developers to interact with applications hosted on the VIP Go platform via the command line.

The 1.12 update includes tooling that can help validate a SQL and media import to help determine whether it’s ready to be migrated to the VIP platform:

The vip import validate-sql command will check a static SQL dump for the basic requirements on the valid import checklist.

vip-import-command-result

The vip import validate-files command will check a media archive to see if its folders are in the required or recommended structure for the import into the VIP Platform.

media-file-validation

You can view more changes in the full changelog on GitHub.

How do I update?

To get this update, you can run the following:

npm install -g @automattic/vip

If you haven’t previously used VIP-CLI, you can start with our installation instructions.

We’re hard at work on further improvements and hope to have more soon. In the meantime, if you’d like to discuss your VIP developer experience or want to help test upcoming releases, please get in touch.

Notice: HTTP Request Log Shipping Now Available

VIP is pleased to announce our HTTP Request Log Shipping feature. Log Shipping allows you to automatically save logs to an Amazon Web Services S3 bucket at 5-minute intervals. The logs are then available to your team for storage, process, or analysis.

HTTP request logs show data about each request made to our edge network of servers. They are a valuable asset in understanding the use of your application, connectivity issues, performance tuning, usage patterns, and in analyzing service interruptions.

What can I do with HTTP request log shipping?

VIP provides log data in order for you to be able to consume this data for analysis that may be useful to your business. Although individual log files are readable by humans, the data can be used and understood more effectively when processed by a third-party tool. Some examples of how this analysis could be useful include:

  • Security: Analyze log data for threat prevention and incident response.
  • Cross reference and corroborate Google Analytics with HTTP traffic: HTTP request logs are a trustworthy source of request data that can provide additional insight into traffic patterns.
  • Content analysis: Use log data to observe patterns in traffic. For instance, you could cross-reference this data with ad metrics.
  • Site performance: Observe request time and response error codes to diagnose site performance issues.
  • Traffic profiling: VIP logs include a country code for the remote address; you can observe traffic patterns by geolocation.
  • SEO: Various SEO tools such as Botify and SEO consultancies will take HTTP Request logs as an input.

How do I set it up?

Setting up Log Shipping requires you to have an AWS S3 bucket as well as the permissions to create an access policy for that bucket.

Vip-dashboard-log-shipping

You can configure Log Shipping for each of your environments from the VIP Dashboard. The configuration process will:

  • Specify an Amazon S3 region and bucket
  • Configure the policy to allow the Log Shipping feature to write to the bucket
  • Test that the write configuration is successful
  • And finally, turn on Log Shipping for that environment.

A full guide to setup is available in VIP’s documentation.

Currently we only provide Log Shipping for your HTTP (web) Request logs. We do intend to add more log types, but we do not have a date to share for those at this time. If you are interested in another log type, please let us know.

Questions?

If you have feedback or questions related to this feature, please open a support ticket and we will be happy to assist.

Resolved: Network Availability Issues at Some Edge Locations

We recently experienced an issue with an upstream network provider that led to a service degradation at some edge locations on our platform, and requests to those locations may have resulted in slow load times or errors.

Sorry for the trouble! Service has been restored, and we will add more details to this post soon.

If you have any questions or are currently experiencing availability issues, please email vip-support@wordpress.com.

Notice: WordPress 5.5 jQuery Compatibility Issues

Yesterday, we released a platform-wide upgrade to WordPress 5.5. Since then, we’ve noticed that some customers experiencing incompatibility issues with custom JavaScript code. This post is to help those customers understand the upgrade and how to resolve issues that may have come up.

If you are seeing new issues such as broken widgets or buttons in your editor, unresponsive buttons like “Publish,” broken page functionality that relies on JavaScript, or new errors in your browser console, these issues may be related to the platform upgrade.

The quick fix

We recommend installing and activating the jQuery Migrate Helper plugin to see if that resolves the issue first. This immediate fix has helped most customers facing issues after the WordPress 5.5 upgrade.

Why are these issues happening?

jQuery is a popular JavaScript library in use on many websites, and included in part of WordPress core.

The WordPress Core team is in the process of upgrading the version of jQuery (1.12) that is bundled with WordPress to the latest release (3.x). Upgrading jQuery brings many security and performance-related improvements. However, it can also introduce breaking changes for customers using older versions. To allow for a safe and smooth transition, the Core team has planned to manage the upgrade over several core releases.

The removal of jQuery migrate 1.x in the WordPress 5.5 release is the first step in this process. Customers that have custom code or plugins that rely on jQuery features that were removed or deprecated prior to jQuery v1 may run into issues like JavaScript errors.

The current schedule for updating the versions of jQuery in WordPress core is laid out in this WordPress Core development note. Following the recommendations of the jQuery team, this update will happen in the following stages:

  1. Remove jQuery Migrate 1.x. This was released on August 11th, 2020 with WordPress 5.5.
  2. Update to the latest version of jQuery and add the latest jQuery Migrate.
    1. This is tentatively planned for WordPress 5.6, depending on test results. (December 2020)
    2. Updating to the latest jQuery UI, version 1.12.1, is also planned for 5.6. (December 2020)
  3. Remove jQuery Migrate. This is tentatively planned for WordPress 5.7 or later, depending on testing. (Spring 2021)

How do I fix this problem?

For an immediate fix: we encourage you to install the jQuery Migrate Helper plugin. This is a short-term fix intended to give your team time to resolve compatibility issues.

For a longer-term fix: we suggest removing this plugin on your development environments, and resolving JavaScript errors there. Once you have your fixes, you can push them to your production environment and deactivate the helper plugin.

To test these changes, there is a plugin that can simulate the changes to different versions of jQuery bundled in code. We encourage you to test the updates well in advance of the pending changes coming in WordPress 5.6, currently scheduled for the end of the year.

How can I prevent compatibility issues from happening in the future?

As part of our managed WordPress service, we are committed to testing and deploying the latest version of WordPress on schedule to keep your site stable, performant, and secure.

Our automated testing catches some issues, however many of the issues with jQuery upgrades happen at the customized application layer. For instance, if you are using plugins that have JavaScript-based customization of your wp-admin screens, you might see breakdown in custom functionality. 

For this reason, we encourage everyone to:

  • Subscribe to email updates from this Lobby, which includes calls for testing for WordPress upgrades.
  • Upgrade your non-production environments to test WordPress release candidates on your environments; you can open a support ticket to request an upgrade.

We will continue to improve our communications to better prepare you for Core releases. If you have suggestions about how you’d like us to contact you, please let us know.

Please don’t hesitate to reach out to the VIP team and open a support ticket, if you need further assistance.

 

Now in the VIP Dashboard: Site access restriction methods

The VIP Dashboard has several new features in the “Settings” screen. Both the “IP Allow List” and “Basic Authentication” settings allow you to restrict access to all content on your site at the platform level.

Using the IP Allow List setting, you can restrict access to your VIP sites to a subset of IP addresses or ranges. For instance, for an intranet or private site, you might use IP Allow List restrictions to restrict access to only known corporate networks.

IP Allow list in VIP Dashboard

In the case of Basic Authentication, you can set one or more username/password restrictions on your site. For un-launched sites, you might use Basic Authentication to control who can view the site prior to launch.

Our documentation contains more details on different methods of restricting site access.

If you have any questions related to this feature, please open a support ticket and we will be happy to assist.

Call for Testing: WordPress 5.5 (Beta)

WordPress 5.5 is scheduled for public release on Tuesday, August 11, 2020, and the 5.5 Beta 1 release is now available for testing.

What Is Being Added or Changed?

Block editor: features and improvements

WordPress 5.5 will include ten releases of the Gutenberg plugin, bringing with it a long list of exciting new features. Here are just a few:

  • Inline image editing – Crop, rotate, and zoom photos inline right from image blocks.
  • Block patterns – Building elaborate pages can be a breeze with new block patterns. Several are included by default.
  • Device previews – See how your content will look to users on many different screen sizes.
  • End block overwhelm. The new block inserter panel displays streamlined categories and collections. As a bonus, it supports patterns and integrates with the new block directory right out of the box.
  • Discover, install, and insert third-party blocks from your editor using the new block directory.
  • A better, smoother editing experience with: 
    • Refined drag-and-drop
    • Block movers that you can see and grab
    • Parent block selection
    • Contextual focus highlights
    • Multi-select formatting lets you change a bunch of blocks at once 
    • Ability to copy and relocate blocks easily
    • And, better performance
  • An expanded design toolset for themes.
  • Now add backgrounds and gradients to more kinds of blocks, like groups, columns, media & text
  • And support for more types of measurements — not just pixels. Choose ems, rems, percentages, vh, vw, and more! Plus, adjust line heights while typing, turning writing and typesetting into the seamless act.

XML sitemaps

XML Sitemaps are now included in WordPress and enabled by default. Sitemaps are essential to search engines discovering the content on your website. Your site’s home page, posts, pages, custom post types, and more will be included to improve your site’s visibility.

When testing, you will want to test any custom functionality related to sitemaps. For instance, if you are using another sitemap-generating plugin such as msm-sitemaps, and don’t want to use the new Core sitemaps, you’ll need to add a filter:

// Disable WordPress 5.5-era sitemaps.
add_filter( 'wp_sitemaps_enabled', '__return_false' );

Auto-updates for plugins and themes

WordPress 5.5 also brings auto-updates for plugins and themes.

Auto-updates will not work VIP Go platform because of our Git-based workflow and read-only filesystem. These features of the VIP infrastructure help prevent malicious or vulnerable code from being auto-deployed on our platform.

Lazy-loading images

WordPress 5.5 will include native support for lazy-loaded images utilizing new browser standards. With lazy-loading, images will not be sent to users until they approach the viewport. This saves bandwidth for everyone (users, hosts, ISPs), makes it easier for those with slower internet speeds to browse the web, saves electricity, and more.

If you are currently using the Lazy Load plugin, we recommend disabling it on upgrade. However, if you are using Jetpack Lazy Load, no changes will be necessary.

Better accessibility

With every release, WordPress works hard to improve accessibility. Version 5.5 is no different and packs a parcel of accessibility fixes and enhancements. Take a look:

  • List tables now come with extensive, alternate view modes.
  • Link-list widgets can now be converted to HTML5 navigation blocks.
  • Copying links in media screens and modal dialogs can now be done with a simple click of a button.
  • Disabled buttons now actually look disabled.
  • Meta boxes can now be moved with the keyboard.
  • A custom logo on the front page no longer links to the front page.
  • Assistive devices can now see status messages in the Image Editor.
  • The shake animation indicating a login failure now respects the user’s choices in the prefers-reduced-motion media query.
  • Redundant Error: prefixes have been removed from error notices.

For a more detailed list of changes, see the Beta release announcement.

When Will WordPress 5.5 Be Deployed?

VIP Go: WordPress 5.5 will be rolled out to all WordPress.com VIP and VIP Go sites on Tuesday, August 11, 2020.

WordPress.com VIP: As with all Core upgrades, we’ll be pushing incremental updates leading up to the public release.

Please note that the deployment dates are subject to change if critical issues are discovered during testing or the public release is delayed. We’ll post updates to the Lobby if the dates do change.

What Should I Do?

We highly recommend updating your local development environments to the beta release using the Beta Tester plugin or updating it to track 5.5 (i.e. trunk) via either the Subversion or GitHub repos.

For sites on VIP Go, you can have your non-production sites switched to WordPress 5.5. Currently, this means switching to the “Trunk” branch with active development. If this is something you’re interested in, please open a ticket and we can set it up for you.

And, as always, if you have any questions related to this release, please open a support ticket and we will be happy to assist.

New Release: WordPress 5.4.2

This notice relates to the following platforms: WordPress.com and VIP Go

WordPress 5.4.2 has been deployed to the WordPress.com platform, as well as all sites on VIP Go running WordPress 5.4. For those sites on VIP Go that were running WordPress 5.3.3, they are upgraded to the patch version WordPress 5.3.4.

What is being added or changed?

WordPress 5.4.2 is a security and maintenance release that features 23 fixes and enhancements.

For more details about this release (including specific changes), please see the announcement post.

Questions?

If you have any questions, related to this release, please open a support ticket and we will be happy to assist.

Updates to the VIP Dashboard

The VIP Dashboard has been updated and now includes an “Organization screen.” This screen includes a list of users associated with your organization, as well as the names of VIP team members who work directly with your account, such as relationship managers and technical account managers.

You can access this screen by selecting the organization name in your dashboard’s sidebar.

dashboard sidebar

If you see any user information that needs to be updated, please feel free to reach out to VIP support, and we will update our records.

VIP Support Contact List

If you have any questions related to this feature, please open a support ticket and we will be happy to assist.