Documentation / Setting up Staatic / Changelog

Changelog

1.9.1

Release date: February 24th, 2024.

Improvements

  • Improves overall compatibility with WPML plugin.
  • Adds support for spaces in additional URLs, paths, redirects and exclude rules.

Fixes

  • Fixes URL detection on WPML installations.
  • Fixes additional path URL conversion on Windows environment.
  • Ensures consistent override of site’s base URL and WordPress URL.

1.9.0

Release date: February 20th, 2024.

Improvements

  • Re-enables compression of publication resources files.
  • Adds support for symlinked uploads directory when having “Symlink/Copy Uploads” setting enabled.
  • Improves environment specific path and URL detection for providing default configurations.
  • Improves display of publication log summary on publication detail screen.
  • Displays a notice for live publication status if preparation takes longer than expected.
  • Allows the database to be reset in case database upgrades fail.
  • Adds support for AWS region ca-west-1.
  • Updates external dependencies.

Fixes

  • Fixes reliability issue with compression of publication resource files.
  • Delays scheduling of events while schedule does not exist.
  • Fixes sorting latest publication overview by publisher and status.
  • Ensures that the search integration links search results to the preview site within the preview index. (Premium)

1.8.2

Release date: February 9th, 2024.

Fixes

  • Temporarily halts compression of publication resource files due to reliability issue.

1.8.1

Release date: February 9th, 2024.

Improvements

  • Follows redirects on provided URLs during publish changes/selection.
  • Compresses publication resource files to reduce disk usage.
  • Improves plugin configuration on Site Health info screen for undefined values.
  • Improves field detection for WPForms Form integration. (Premium)

Fixes

  • Fixes an edge case with normalizing empty path URLs causing duplicate index files.
  • Fixes some untranslatable language strings.

1.8.0

Release date: January 31st, 2024.

Features

  • Adds “SFTP Server” deployment method (beta).
  • Adds --only-urls, --only-paths and --[no-]deploy arguments to WP-CLI publish command.
  • Adds staatic redeploy WP-CLI command to allow publications to be redeployed from the commandline.
  • Adds “Enforce lowercase URLs” setting for consistent formatting and to prevent case-sensitive duplicate content.
  • Adds “Custom Origin URL” setting for manual override of the site’s home URL.
  • Adds advanced options for following/saving/recursive scanning to “Additional Paths” setting.
  • Adds filter hooks for deploment specific configuration files: staatic_netlify_config_file, staatic_apache_config_file, staatic_nginx_config_file and staatic_staatic_config_file.
  • Adds staatic_extended_url_context filter hook to provide additional context when evaluating and transforming URLs.

Improvements

  • Improves overall compatibility with Avada page builder plugin.
  • Improves overall compatiblity with Bedrock WordPress boilerplate.
  • Adds support for AWS regions il-central-1 and ap-southeast-4.
  • Improves URL extraction from HTML srcset attributes.
  • Improves GitHub deployment method performance.
  • Keeps track of crawled resources based on transformed URL instead of origin URL.
  • Prevents modifying binary resources even though mime type indicates text/html.
  • Various admin interface UX improvements.
  • Updates external dependencies.

Fixes

  • Corrects transformation of specific URLs when using the “Offline URL” destination URL.
  • Fixes handling of follow/save options in “Additional URLs” setting.
  • Compares normalized URLs when merging publications. (Premium)
  • Clears form cache when updating or deleting forms. (Premium)

1.7.0

Release date: December 14th, 2023.

Features

  • Adds GitHub deployment method.
  • Adds “Publish Selection” feature to publish specific URLs or file system paths.
  • Adds staatic_replace_live_urls, staatic_should_crawl_url and staatic_url_evaluators filter hooks.
  • Adds staatic_publish and staatic_publish_subset user capabilities.

Improvements

  • Displays API connection status when configuring Netlify deployment method.
  • Improves memory usage during processing of large files in “Local Directory” deployment method.
  • Gracefully handles File name too long in “Local Directory” deployment method.
  • Prevents users from setting the WordPress installation directory as an additional path.
  • Improves XML sitemap detection by adding support for sitemaps.xml.
  • Handles errors from staatic_publication_task_[before|after] hooks more gracefully.
  • Updates external dependencies.

Fixes

  • Prevents loading of widgets without correct capabilities.
  • Corrects XML instruction injection before <html> with “PHP DOM Wrapper”.
  • Fixes source tracking for debug logs.
  • Prevents displaying unauthorized form management actions. (Premium)

1.6.3

Release date: November 8th, 2023.

Improvements

  • Allows publications that have started deployment to be redeployed.
  • Updates external dependencies.

Fixes

  • Fixes database schema setup issue, which may break handling of long URLs.
  • Fixes potential zip file corruption with publication download.

1.6.2

Release date: October 18th, 2023.

Improvements

  • Improves fallback URL extraction from any asset type to support various edge cases.
  • Increases size of table identifier columns to support larger datasets.
  • Updates external dependencies.

Fixes

  • Fixes database schema setup issue, which may break partial publications.
  • Fixes automatic plugin updates. (Premium)

1.6.1

Release date: September 25th, 2023.

Features

  • Adds (basic) redirect integration for RankMath Plugin.
  • Extends “Publish Changes” feature to include archive pages. (Premium)
  • Extends “Publish Changes” feature to support additional URLs. (Premium)

Improvements

  • Improves URL extraction from CSS assets to support various edge cases.
  • Improves URL extraction from XML sitemaps to support various edge cases.
  • Improves fallback URL extraction from any asset type to support various edge cases.
  • Updates external dependencies.

1.6.0

Release date: August 28th, 2023.

Features

  • Adds “Retain Files/Directories” setting to Amazon S3 (or compatible) deployment method.

Improvements

  • UX improvements to “Retain Files/Directories” settings.
  • Improves detection of environment variables when overriding settings.
  • Improves handling of symlinks while using “Additional Paths” setting.
  • Updates external dependencies.

Fixes

  • Fixes rendering of textarea settings when used as part of composed settings.
  • Ensures redirects are always updated when using Staatic Cloud deployment method. (Premium)
  • Fixes type error in site health check. (Premium)
  • Fixes publish on event automation. (Premium)

1.5.0

Release date: August 4th, 2023.

Features

  • Integrates config checker and diagnostics into WordPress Site Health screen.
  • Adds support for Divi Contact Form integration. (Premium)

Improvements

  • Improves error handling of invalid WordPress site URL configuration.
  • Enforces absolute URLs when URLs are added from crawl url providers.
  • Excludes /wp-content/uploads/cache directory from configured “Additional Paths”.
  • Upon installation creates database structure at once, skipping migrations.
  • Automatically corrects URL paths starting with duplicate slashes when using relative destination URLs.
  • Various performance optimizations and improved garbage collection.
  • Updates external dependencies.
  • Extends support for Gravity Forms integration. (Premium)
  • Allows the list of forced file extensions to be updated for use with “Publish Changes”. (Premium)
  • Adds support for automatic updates for Staatic Premium. (Premium)

Fixes

  • Prevents Staatic from appearing in admin bar when visible for guests.
  • Truncates long URLs to 2083 characters to prevent database errors.
  • Correctly determines file paths for URI’s containing .html in AWS and Netlify deployment methods.

1.4.5

Release date: May 29th, 2023.

Improvements

  • Adds dedicated “Staatic Maintenance” cron interval (by default set to twice daily).

Fixes

  • Fixes plugin deactivation failure.
  • Fixes potential PHP deprecation error in database migrator.
  • Fixes potential PHP type errors in AWS deployment method.

1.4.4

Release date: May 24th, 2023.

Improvements

  • Changes default value of “Publication Task Timeout” setting to 180 seconds.
  • Adds staatic_publication_task_timeout filter hook to allow timeout value to be overridden.
  • Displays clearer error message when publication task fails due to a timeout or fatal error.
  • Replaced staatic_publication_[before|after]_task hooks by staatic_publication_task_[before|after].
  • Improves performance of the publication resources cleanup process.
  • Improves performance of remote deployment methods.
  • Adds diagnostics screen, accessible from /wp-admin/admin.php?page=staatic-diagnostics.
  • Considers XML sitemaps to be assets, allowing these to be included in partial publications. (Premium)
  • Delays publications triggered from “Publish on Event” setting to ensure all changes are published. (Premium)

Fixes

  • Unlocks background publisher process lock when publication is canceled.
  • Ensures Premium WP-CLI commands overwrite community WP-CLI commands. (Premium)
  • Fixes tracking change events for posts with modified permalinks. (Premium)

1.4.3

Release date: April 21st, 2023.

Features

  • Adds (basic) redirect integration for Yoast Premium Plugin.
  • Adds support for scheduled posts when “Automatically schedule a publication when a post is saved” is enabled. (Premium)

Improvements

  • Changes default value of “Publication Task Timeout” setting to 60 seconds.
  • Improves self connect tests in config checker.

Fixes

  • Fixes URI path to S3 key in AWS deploy strategy when using permalinks without a trailing slash.

1.4.2

Release date: April 4th, 2023.

Improvements

  • Improves the default batch sizes during the crawl and deploy phases of the publication process.
  • Improves display of potential failure details in publication logs table.
  • Adds “Publication Task Timeout” (advanced) setting to resolve potential publication issues.
  • Adds progress percentage to live publication status.
  • Improves compatibility with PHP 8 and higher.
  • Updates external dependencies.
  • Uses the configured HTML DOM parser during form transformation when form integration is enabled. (Premium)

Fixes

  • Fixes issue where first publication does not store generated resources on file system.
  • Fixes the default value of the “Excluded URLs” build setting.
  • Fixes display of settings using list style.
  • Uses the correct filter hook staatic_deploy_batch_size to determine the batch size while deploying.

1.4.1

Release date: March 10th, 2023.

Improvements

  • Adds native support for data-srcset and data-wpfc-original-srcset HTML srcset attributes.
  • Adds staatic_html_mapping_tags and staatic_html_mapping_srcset filter hooks.

Fixes

  • Uses the correct region while deploying to an Amazon S3 (or compatible) bucket.
  • Fixes the content type for resources with charset while deploying to an Amazon S3 (or compatible) bucket.

1.4.0

Release date: January 30th, 2023.

Features

  • Adds “HTML DOM parser” crawler setting to allow you to change the HTML DOM parser used while crawling.
  • Adds “Process page not found resources” crawler setting, which by default is set to disabled.

Improvements

  • Improves performance and reliability of publication task processing.
  • Adds filter hooks staatic_crawl_batch_size and staatic_deploy_batch_size to allow fine-tuning publication performance.
  • Adds support for AWS regions ap-south-2, eu-central-2, eu-south-2 and me-central-1.
  • Prevents PHP warnings when supplying invalid regular expressions in exclude URLs setting.
  • Adds support for database migrations with beta releases.
  • Increases PHP time limit during database migrations and publications.
  • Ensures that the WordPress debug log is excluded when it is within a configured additional path.
  • Updates external dependencies.
  • Includes pages related to terms and taxonomies in quick publications. (Premium)
  • Allows the search query used by the posts search index to be customized using the staatic_posts_search_index_query filter hook. (Premium)

Fixes

  • Uses the correct region while deploying to an Amazon S3 (or compatible) bucket.
  • Corrects display of numbers and sizes in certain languages.
  • Ensures that staatic-[created|updated]-at meta tags are only present when using Staatic Cloud. (Premium)
  • Marks publications resulting from redeployment of preview publication as preview as well. (Premium)

Note: this update changes the default HTML DOM parser from Simple Html Dom Parser to PHP DOM Wrapper, because the first appeared to suffer from a memory leak. Different HTML DOM parsers may produce slightly different HTML output.

1.3.4

Release date: December 22nd, 2022.

Improvements

  • Adds support for regular expressions in excluded URLs setting.
  • Adds validation to filesystem target directory setting to prevent accidential data loss.

Fixes

  • Utilizes internal URL normalizer, correcting issues with partially secure WordPress sites (http/https).
  • Utilizes STAATIC_KEY constant in wp-config.php while encrypting/decrypting secrets when available.
  • Fixes form notifications setting. (Premium)
  • Makes form honeypot field readonly to prevent accidental automatic input by browsers. (Premium)

1.3.3

Release date: November 4th, 2022.

Improvements

  • Adds URL transformation support for XSLT assets.
  • Adds configuration test to verify homepage accessibility.
  • Displays detailed error information in case a publication fails.
  • Improves description of configuration test failures.
  • Improves overall compatibility with Elementor page builder plugin.
  • Improves support for questionable URLs with duplicate slashes in its path segment.
  • Improves excluded URL matching algorithm.
  • Updates external dependencies.

Fixes

  • Fixes undefined array key warning when HTTP_USER_AGENT is not defined.

1.3.2

Release date: October 25th, 2022.

Improvements

  • Improves support for AWS authentication using IAM security credentials from AWS EC2 instances and AWS ECS containers.
  • Tests AWS connectivity before starting publications using the AWS deployment method.
  • Improves compatibility with plugins using http_request_args filter hook without passing a valid URL.

Fixes

  • Fixes PHP 7.0 downgrade issue in external HTTP library causing AWS deployment failures in rare cases.

1.3.1

Release date: October 1st, 2022.

Features

  • Adds WP-CLI command “staatic migrate” to manually upgrade or downgrade the database.

Improvements

  • Improves database upgrades with new versions and adds the ability to retry failed upgrades.
  • Improves handling of encrypted settings in combination with invalid/modified encryption key.
  • Updates external dependencies.

Fixes

  • Restores compatibility with PHP 7.0-7.1.

1.3.0

Release date: August 30th, 2022.

Features

  • Adds support for alternative S3-compatible providers by accepting a custom endpoint in the S3 deployment method.
  • Allows the maximum number of invalidation paths to be adjusted when invalidating the CloudFront cache.
  • Allows the path to invalidate everything from the CloudFront cache to be adjusted.
  • Adds the ability to apply a canned ACL to uploaded files in the S3 deployment method.
  • Stores sensitive setting values (passwords, keys and tokens) in encrypted form.

Improvements

  • Improves overall compatibility with Elementor page builder plugin.
  • Skips transformation of fragment-only links while processing HTML files, resolving an issue with Elementor Popups.
  • Increases maximum length of supported URLs from 255 to 2083 characters.
  • Updates external dependencies.

Fixes

  • Fixes handling of HTML entities while extracting links from HTML documents, resolving issues with obfuscated mailto-links and SVG data URLs.

1.2.2

Release date: August 17th, 2022.

Improvements

  • When HTTP basic authentication credentials are provided, these will now be used to authenticate any internal request.
  • Adds staatic_netlify_config_extra filter hook to allow additions to the generated netlify.toml file when using the Netlify deployment method.
  • Adds staatic_additional_urls and staatic_additional_paths filter hooks to allow additional urls and paths to be dynamically added.
  • Detects and includes wp-emoji assets in build.

Fixes

  • Fixes edge case causing transformed HTML resources to be incomplete.

1.2.1

Release date: July 28th, 2022.

Features

  • Allows publication logs to be exported.

Improvements

  • Automatically excludes Contact Form 7 captcha and uploads directories as part of additional paths setting.
  • Clears plugin transient cache after upgrading plugin.
  • Updates external dependencies.

Fixes

  • Removes wp_oembed discovery links while crawling site due to incompatible URL-structure.
  • Fixes edge case causing incorrect publication status after canceling a publication in progress.

1.2.0

Release date: July 2nd, 2022.

Features

  • Allows (past) publications to be redeployed, making it possible to quickly revert after a mistake.

Improvements

  • Improves XML sitemap detection and changes default additional URL to /wp-sitemap.xml.
  • Automatically detects the sitemap URL from /robots.txt.
  • Improves plugin compatibility with Windows environments.
  • Improves plugin compatibility with WordPress installations within a subdirectory.
  • Optimizes build files storage, improving overall performance and reducing disk usage.
  • Various technical improvements in crawler component.

Fixes

  • Excludes results without content in Netlify upload manifest.
  • Fixes edge case in database migration coordinator that can cause an error while upgrading/downgrading.

1.1.1

Release date: June 17th, 2022.

Improvements

  • Changes defaults of “Delete plugin settings” and “Delete plugin data” settings to enabled.
  • Adds support for “ap-southeast-3” and “ap-northeast-3” regions to AWS deployment method.

Fixes

  • Correctly fixes edge case with additional paths setting when path is a symlink.
  • Fixes edge case with result transformer not rewinding resource file pointer.
  • Ensures uninstalling plugin data removes all plugin database tables.

1.1.0

Release date: June 2nd, 2022.

Features

  • Adds “Offline URL” option to “Destination URL” setting to enable locally browsable sites.
  • Adds ability to use path in “Destination URL” setting to enable sites to be hosted in subdirectories.
  • Adds ability to not follow or save results originating from additional URLs.
  • Adds zipfile deployment method to allow for manual deployments.
  • Adds “Downgrade HTTP to HTTPS” setting to improve compatibility on specific environments.
  • Adds “Logging” setting to make logging verbosity configurable.
  • Adds ability to export diagnostics to assist with support requests.

Improvements

  • Improves user experience when configuring additional URLs, paths and redirects as well as excluded URLs.
  • Improves detection and transformation of URLs while building the static site.
  • Changes “Destination URL” default value to “/” instead of site URL.

Fixes

  • Fixes transformation errors with redirect plugin integrations.
  • Updates result hashes and size correctly after applying transformers and post processors.

1.0.8

Release date: April 18th, 2022.

Features

  • Adds ability to download publications as a zip file.
  • Adds ability to bulk delete publications.

Improvements

  • Emphasises the active publication on the publication overview.
  • Displays original publication result URL in tooltip.
  • Updates external dependencies.
  • Various code style improvements.

Fixes

  • Fixes edge case with additional paths setting when path is a symlink.

1.0.7

Release date: March 28th, 2022.

Features

Improvements

  • UX improvements to additional/exclude URLs, additional paths and additional redirects settings.
  • Adds [–[no-]preview] WP-CLI option to staatic publish command.
  • Updates external dependencies.

Fixes

  • Ensures filesystem deployment method target directory is always excluded from build.

1.0.6

Release date: February 16th, 2022.

Improvements

  • Adds basic support for preview publications.
  • Updates external dependencies.

1.0.5

Release date: November 3rd, 2021.

Improvements

  • Adds ability to delete publications from publication overview.
  • Adds support for WP Fastest Cache srcset attribute.

Fixes

  • Displays translated texts in dynamic components correctly.
  • Displays dates with preferred timezone.

1.0.4

Release date: October 6th, 2021.

Improvements

  • Adds publish button to publication overview.
  • Optimizes AWS deployment method URL/path conversion.

Fixes

  • Ensures http basic auth parameters are passed when publishing.

1.0.3

Release date: September 2nd, 2021.

Improvements

  • Various performance improvements.

Fixes

  • Ensures database migrations are executed after plugin upgrade.
  • Correctly cleans up expired deployment results.
  • Improves loading of plugin settings.

1.0.2

Release date: June 28th, 2021.

Improvements

  • Makes plugin source code more readable.

1.0.1

Release date: June 18th, 2021.

Fixes

  • Fixes a bug where uninstalling the plugin would fail.

1.0.0

Release date: June 18th, 2021.

  • Initial release.