Skip to content

Releases: hydephp/develop

v2.0.0

01 Oct 13:52
0df4fc8

Choose a tag to compare

What's Changed

Read more

HydePHP v2 Release Candidate Four

30 Sep 17:32
819b663

Choose a tag to compare

Pre-release

What's Changed

Full Changelog: v2.0.0-RC.3...v2.0.0-RC.4

HydePHP v2 Release Candidate Three

01 Jun 16:54
f87dda1

Choose a tag to compare

Pre-release

What's Changed

  • Forward DateString method calls to DateTime instances by @Cyberking99 in #2235
  • [2.x] Fix rebuild command showing the wrong console output by @nats-afs in #2240

New Contributors

Full Changelog: v2.0.0-RC.2...v2.0.0-RC.3

HydePHP v2 Release Candidate Two

24 May 21:05
f2ea9cc

Choose a tag to compare

Pre-release

What's Changed

Full Changelog: v2.0.0-RC.1...v2.0.0-RC.2

HydePHP v2 Release Candidate One

24 May 20:51
5e2dfa2

Choose a tag to compare

Pre-release

At long last, this is the first release candidate for HydePHP v2.0. Please stay tuned for the official release which will contain the finalized changeset and release notes with upgrade guide. However, for those who are curious - feel free to start testing this right now!

What's Changed

Read more

v1.8.0 - 2025-05-17

17 May 14:52
aaba852

Choose a tag to compare

1.8.0 - 2025-05-17

Added

  • Updated the HydeKernel array representation to include the Hyde version in #1786
  • Registered the cache:clear command to make it easier to clear the cache in #1881
  • Added a new Hyperlinks::isRemote() helper method to check if a URL is remote in #1882
  • All page types now support the description front matter field (used in page metadata) in #1884
  • Added a new Filesystem::findFiles() method to find files in a directory in #2064
  • Added webp to the list of default media extensions in hydephp/framework#663
  • Added a new slug generation helper to improve internationalization support in #2070

Changed

  • Changed the Hyde facade to use a @mixin annotation instead of single method annotations in #1919
  • Updated the Serializable trait to provide a default automatic toArray method in #1791
  • Updated the PostAuthor class's name property to fall back to the username property if the name property is not set in #1794
  • Removed the nullable type hint from the PostAuthor class's name property as it is now always set in #1794
  • Improved the accessibility of the heading permalinks feature in #1803
  • The torchlight:install command is now hidden from the command list as it's already installed in #1879
  • Updated the home page fallback link in the 404 template to lead to the site root in #1880 (fixes #1781)
  • Normalized remote URL checks so that protocol relative URLs // are consistently considered to be remote in all places in #1882 (fixes #1788)
  • Page slugs are now generated using our automatically internationalizing slug generator to transliterate input to ASCII in #2070
  • Replaced internal usages of glob functions with our improved file finder in #2064
  • Updated to HydeFront v3.4 in #1803
  • Realtime Compiler: Virtual routes are now managed through the service container in #1858
  • Realtime Compiler: Improved the dashboard layout in #1866
  • Realtime Compiler: Shorten the realtime compiler server start message from "Press Ctrl+C to stop" to "Use Ctrl+C to stop" to better fit 80 column terminals in #2017

Deprecated

  • The PostAuthor::getName() method is now deprecated and will be removed in v2. (use $author->name instead) in #1794
  • Deprecated the FeaturedImage::isRemote() method in favor of the new Hyperlinks::isRemote() method in #1882
  • Deprecated the Hyde::mediaLink() method in favor of the Hyde::asset() method in #1993

Fixed

  • Fixed Tailwind content paths for nested Blade pages in #2042
  • Added missing collection key types in Hyde facade method annotations in #1784
  • Fixed heading permalinks button text showing in Google Search previews #1801 in #1803
  • Fixed routing issues with nested 404 pages where an index page does not exist #1781 in #1880
  • Fixed URL metadata for blog posts not using customized post output directories in #1889
  • Fixed lacking support for logographic slug generation hydephp/hyde#269 in #2070
  • Improved printed documentation views in #2005
  • Fixed "BuildService finding non-existent files to copy in Debian" hydephp/framework#662 in #2064
  • Fixed "Undefined constant Hyde\Foundation\Kernel\GLOB_BRACE" hydephp/hyde#270 in #2064
  • Realtime Compiler: Updated the exception handler to match HTTP exception codes when sending error responses in #1853
  • Realtime Compiler: Improved routing for nested index pages in #1852
  • Realtime Compiler: Improved the dashboard #1866 fixing hydephp/realtime-compiler#22 and hydephp/realtime-compiler#29
  • Realtime Compiler: Fixed support for serving media assets in subdirectories hydephp/realtime-compiler#26 in #1872

What's Changed in the Monorepo

Read more

v1.7.0 - 2024-07-05

05 Jul 13:08
50b5ce7

Choose a tag to compare

1.7.0 - 2024-07-05

Added

  • Added support for using HTML comments to create Markdown code block filepath labels in #1693
  • Added a config option to disable the theme toggle buttons to automatically use browser settings in #1697
  • You can now specify which path to open when using the --open option in the serve command in #1694
  • Added a --format=json option to the route:list command in #1724

Changed

  • When a navigation group is set in front matter, it will now be used regardless of the subdirectory configuration in #1703 (fixes #1515)
  • Use late static bindings to support overriding data collections file finding in #1717 (fixes #1716)
  • Method Hyde::hasSiteUrl() now returns false if the site URL is for localhost in #1726
  • Method Hyde::url() will now return a relative URL instead of throwing an exception when supplied a path even if the site URL is not set in #1726
  • Updated the .env.example file to contain more details on the site URL setting's usages in #1746
  • Added a version prefix to the sitemap's generator attribute in #1767
  • Setting a site name in the Yaml config file will now influence all configuration values where this is used, unless already set, in #1770 and #1773

Deprecated

  • Deprecated the global unslash() function, replaced with the existing namespaced \Hyde\unslash() function in #1753
  • Deprecated the BaseUrlNotSetException class in #1759

Removed

  • The Git version is no longer displayed in the debug screen and dashboard in #1756

Fixed

  • Fixed explicitly set front matter navigation group behavior being dependent on subdirectory configuration, fixing #1515 in #1703
  • Fixed DataCollections file finding method not being able to be overridden #1716 in #1717
  • Fixed PHP warning when trying to parse a Markdown file with just front matter without body #1705 in #1728
  • Fixed #1748 by normalizing generator version prefixes in #1767
  • Yaml data files no longer need to start with triple dashes to be parsed by DataCollections in #1733
  • Updated the Hyde URL helper to not modify already qualified URLs in #1757

Extra information

This release contains changes to how HydePHP behaves when a site URL is not set by the user.

These changes are made to reduce the chance of the default localhost value showing up in production environments.

Most notably, HydePHP now considers that default site URL localhost to mean that a site URL is not set, as the user has not set it.
This means that things like automatic canonical URLs will not be added, as Hyde won't know how to make them without a site URL.
The previous behaviour was that Hyde used localhost in canonical URLs, which is never useful in production environments.

For this reason, we felt it worth it to make this change in a minor release, as it has a such large benefit for sites.

You can read more about the details and design decisions of this change in the following pull request #1726.

What's Changed in the Monorepo

What's Changed

Read more

v1.6.0 - 2024-04-17

17 Apr 12:57
39a7e5a

Choose a tag to compare

1.6.0 - 2024-04-17

Added

  • Added a @head stack to the head.blade.php component in #1567
  • Added a Hyde::route() helper to the Hyde facade in #1591
  • Added new global helper functions (asset(), route(), url()) in #1592
  • Added a new Feature enum to improve the Features facade in #1650
  • Added a helper to ->skip() build tasks in #1656

Changed

  • The features array in the config/hyde.php configuration file is now an array of Feature enums in #1650
  • Sitemap generation will now be skipped if a base URL is not set, as Google now will not index sitemaps without a base URL in #1660
  • Updated the debug command to print the binary path when running in a standalone Phar in #1667

Deprecated

  • Deprecated the static Features flag methods used in the configuration files in #1650 which will be removed in HydePHP v2.0

Fixed

  • Fixed a bug where the sitemap and RSS feed generator commands did not work when the _site/ directory was not present in #1654
  • Fixed extra newlines being written to console for failing build tasks in #1661
  • Markdown formatting will now be stripped when generating an automatic blog post description when none is set in #1662 (fixes #1634)
  • Realtime Compiler: Fixed responsive dashboard table issue in #1595

Upgrade Path

In order to prepare your project for HydePHP v2.0, you should update your config/hyde.php configuration file to use the new Feature enum for the features array.

You can see the changes to make in your Hyde project by looking at the following pull request https://github.com/hydephp/hyde/pull/250/files

Your new config array should look like this:

    // Make sure to import the new Feature enum at the top of the file 
    use Hyde\Enums\Feature;
    
    // Then replace your enabled features with the new Feature enum cases
    'features' => [
        // Page Modules
        Feature::HtmlPages,
        Feature::MarkdownPosts,
        Feature::BladePages,
        Feature::MarkdownPages,
        Feature::DocumentationPages,

        // Frontend Features
        Feature::Darkmode,
        Feature::DocumentationSearch,

        // Integrations
        Feature::Torchlight,
    ],

If you need more help, you can see detailed upgrade instructions with screenshots in the pull request #1650

What's Changed in the Monorepo

What's Changed

Full Changelog: v1.5.0...v1.6.0

v1.5.0 - 2024-02-13

13 Feb 11:04
53d6aea

Choose a tag to compare

1.5.0 - 2024-02-13

Improved Patch Release Strategy

This release experiments some changes into how releases are handled to clarify the patch versioning of distributed packages compared to the monorepo source versioning.

In short: We are now experimenting with rolling patch releases, where patches are released as soon as they're ready, leading to faster rollout of bugfixes.
This means that the patch version discrepancy between the monorepo and the distributed packages will be increased, but hopefully the end results will still be clearer,
thanks to the second related change: Prefixing the subpackage changes in this changelog with the package name. If there is no prefix, the change applies to the core package or the monorepo.

All this to say, please keep in mind that when the monorepo gets a new minor version, the prefixed changes may already have been released as patches in their respective packages.

Added

  • Added the existing media_extensions option to the hyde configuration file in #1531
  • Added configuration options to add custom HTML to the <head> and <script> sections in #1542
  • Added support for adding custom HTML to the <head> and <script> sections using HTML includes in #1554
  • Added an html helper to the Includes facade in #1552

Changed

  • Renamed local template variable $document to $article to better match the usage in #1506
  • Updated semantic documentation article component to support existing variables in #1506
  • Updated the Markdown to plain text converter to trim whitespace in #1561
  • HydeFront: Changed <code> styling to display as inline instead of inline-block in #1525
  • Realtime Compiler: Add strict type declarations in #1555
  • Bumped Realtime Compiler version to v3.3 in #1562
  • Internal: Renamed snake case test methods to camel case in #1556

Deprecated

  • Deprecated the BuildService::transferMediaAssets() method in #1533, as it will be moved into a build task in v2.0.

Fixed

What's Changed in the Monorepo

Full Changelog: v1.4.0...v1.5.0

v1.4.0 - 2023-12-11

11 Dec 09:57
b882bf2

Choose a tag to compare

1.4.0 - 2023-12-11

Added

  • Adds a new fancy output for the realtime compiler serve command in #1444
  • Added support for dot notation in the Yaml configuration files in #1478
  • Added a config option to customize automatic sidebar navigation group names in #1481
  • Added a new hyde serve --open option to automatically open the site in the browser in #1483
  • Added a new Live Edit feature to the realtime compiler in #1458

Changed

  • The docs.sidebar.footer config option now accepts a Markdown string to replace the default footer in #1477
  • Links in the sitemap.xml file are now relative when a site URL is not set, instead of using the default localhost URL in #1479
  • Improves the portability of the realtime compiler to better support running through the standalone executable in #1488
  • Bumps realtime compiler version to v3.2 in #1489
  • Support both route keys and identifiers for specifying sidebar order in #1432
  • Updated sitemap generator to use relative links instead of localhost when missing site URL in #1479

Removed

  • Removed unhelpful boilerplate from the hyde/hyde package.json in #1436

Fixed

  • Fixed dot notation in Yaml configuration not being expanded (#1471) in #1478

Internal

  • Internal: Only inject custom app config location when missing from parent in #1485
  • Internal: Remove experimental Phar support from internal configuration loader in #1485

What's Changed in the Monorepo

Full Changelog: v1.3.0...v1.4.0