You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

137 KiB



    • Added ConsoleCommand::setLanguage() method to set language to be used from CLI
    • Added ConsoleCommand::initializeGrav() method to properly set up Grav instance to be used from CLI
    • Added ConsoleCommand::initializePlugins()method to properly set up all plugins to be used from CLI
    • Added ConsoleCommand::initializeThemes()method to properly set up current theme to be used from CLI
    • Added ConsoleCommand::initializePages() method to properly set up pages to be used from CLI
    • Vendor updates
    • Fixed bin/plugin CLI calling $themes->init() way too early (removed it, use above methods instead)
    • Fixed call to $grav['page'] crashing CLI
    • Fixed encoding problems when PHP INI setting default_charset is not utf-8 #2154



    • Fixed incorrect routing caused by str_replace() in Uri::init() #2754
    • Fixed session cookie is being set twice in the HTTP header #2745
    • Fixed session not restarting if user was invalid (downgrading from Grav 1.7)
    • Fixed filesystem iterator calls with non-existing folders
    • Fixed checkbox field not being saved, requires also Form v4.0.2 #1225
    • Fixed validation: strict not working in blueprints #1273
    • Fixed Data::filter() removing empty fields (such as empty list) by default #2805
    • Fixed fatal error with non-integer page param value #2803
    • Fixed Assets::addInlineJs() parameter type mismatch between v1.5 and v1.6 #2659
    • Fixed site.metadata saving issues #2615



    • Catch PHP 7.4 deprecation messages and report them in debugbar instead of throwing fatal error
    • Fixed fatal error when calling {{ grav.undefined }}
    • Fixed multiple issues when there are no pages in the site
    • PHP 7.4 fix for #2750



    • PHP 7.4 fix in Pages::buildSort()
    • Updated vendor libraries for PHP 7.4 fixes in Twig and other libraries
    • Fixed fatal error when $page->id() is null #2731
    • Fixed cache conflicts on pages with no set id
    • Fix rewrite rule for for lighttpd default config #721



    • Added working ETag (304 Not Modified) support based on the final rendered HTML
    • Safer file handling + customizable null char replacement in CsvFormatter::decode()
    • Change of Behavior: Inflector::hyphenize will now automatically trim dashes at beginning and end of a string.
    • Change in Behavior for Folder::all() so no longer fails if trying to copy non-existent dot file #2581
    • renamed composer test-plugins script to phpstan-plugins to be more explicit #2637
    • Fixed PHP 7.1 bug in FlexMedia
    • Fix cache image generation when using cropResize #2639
    • Fix array_merge() exception with non-array page header metadata #2701



    • Fixed Flex user creation if file storage is being used #2444
    • Fixed Badly encoded JSON data warning when uploading files #2663



    • Improved robots.txt #2632
    • Fixed broken markdown Twig tag #2635
    • Force Symfony 4.2 in Grav 1.6 to remove a bunch of deprecated messages



    • Actually include fix for system\router.php #2627



    • Regression fix for system\router.php #2627



    • Added support for custom FormFlash save locations
    • Added a new Utils::arrayLower() method for lowercasing arrays
    • Support new GRAV_BASEDIR environment variable #2541
    • Allow users to override plugin handler priorities #2165
    • Use new Utils::getSupportedPageTypes() to enforce html,htm at the front of the list #2531
    • Updated vendor libraries
    • Markdown filter is now page-aware so that it works with modular references admin#1731
    • Check of GRAV_USER_INSTANCE constant is already defined #2621
    • Fixed some potential issues when $grav['user'] is not set
    • Fixed error when calling Media::add($name, null)
    • Fixed url() returning wrong path if using stream with grav root path in it, eg: user-data://shop when Grav is in /shop
    • Fixed url() not returning a path to non-existing file (user-data://shop => /user/data/shop) if it is set to fail gracefully
    • Fixed url() returning false on unknown streams, such as, they should be treated as external URL
    • Fixed Flex User to have permissions to save and delete his own user
    • Fixed new Flex User creation not being possible because of username could not be given
    • Fixed fatal error 'Expiration date must be an integer, a DateInterval or null, "double" given' #2529
    • Fixed non-existing Flex object having a bad media folder
    • Fixed collections using page@.self: should allow modular pages if requested
    • Fixed an error when trying to delete a file from non-existing Flex Object
    • Fixed FlexObject::exists() failing sometimes just after the object has been saved
    • Fixed CSV formatter not encoding strings with " and , properly
    • Fixed var order in Validation.php #2610



    • Added FormTrait::getAllFlashes() method to get all the available form flash objects for the form
    • Added creation and update timestamps to FormFlash objects
    • Added FormFlashInterface, changed constructor to take $config array
    • Fixed error in ImageMedium::url() if the image cache folder does not exist
    • Fixed empty form flash name after file upload or form state update
    • Fixed a bug in Route::withParam() method
    • Fixed issue with FormFlash objects when there is no session initialized



    • Added page blueprints to YamlLinter CLI and Admin reports
    • Removed Gitter and Slack #2502
    • Optimizations for Plugin/Theme loading
    • Generalized markdown classes so they can be used outside of Page scope with a custom Excerpts class instance
    • Change minimal port number to 0 (unix socket) #2452
    • Force question to install demo content in theme update #2493
    • Fixed GPM errors from blueprints not being logged #2505
    • Don't error when IP is invalid #2507
    • Fixed regression with bin/plugin not listing the plugins available (1c725c0)
    • Fixed bitwise operator in TwigExtension::exifFunc() #2518
    • Fixed issue with lang prefix incorrectly identifying as admin #2511
    • Fixed issue with U0ils::pathPrefixedBYLanguageCode() and trailing slash #2510
    • Fixed regresssion issue of Utils::Url() not returning false on failure. Added new optional fail_gracefully 3rd attribute to return string that caused failure #2524



    • Added Route::withoutParams() methods
    • Added Pages::setCheckMethod() method to override page configuration in Admin Plugin
    • Added Cache::clearCache('invalidate') parameter for just invalidating the cache without deleting any cached files
    • Made UserCollectionInderface to extend Countable to get the count of existing users
    • Flex admin: added default search options for flex objects
    • Flex collection and object now fall back to the default template if template file doesn't exist
    • Updated Vendor libraries including Twig 1.40.1
    • Updated language files from
    • Fixed $grav['route'] from being modified when the route instance gets modified
    • Fixed Assets options array mixed with standalone priority #2477
    • Fix for avatar_url provided by 3rd party providers
    • Fixed non standard lang code lengths in Utils and Session detection
    • Fixed saving a new object in Flex SimpleStorage
    • Fixed exception in Flex::getDirectories() if the first parameter is set
    • Output correct "Last Updated" in bin/gpm info command
    • Checkbox getting interpreted as string, so created new Validation::filterCheckbox()
    • Fixed backwards compatibility to select field with selectize.create set to true git-sync#141
    • Fixed YamlFormatter::decode() to always return array #2494
    • Fixed empty $grav['request']->getAttribute('route')->getExtension()



    • Added FlexCollection::filterBy() method
    • Revert Use Null Coalesce Operator #2466
    • Fixed FormTrait::render() not providing config variable
    • Updated bin/grav clean to clear cache/compiled and user/config/security.yaml



    • Added a new bin/grav yamllinter CLI command to find YAML Linting issues #2468
    • Improve FormTrait backwards compatibility with existing forms
    • Added a new Utils::getSubnet() function for IPv4/IPv6 parsing #2465
    • Remove disabled fields from the form schema
    • Fix issue when excluding inlineJs and inlineCss from Assets pipeline #2468
    • Fix for manually set position on external URLs #2470



    • FormInterface now implements RenderInterface
    • Added new FormInterface::getTask() method which reads the task from form.task in the blueprint
    • Updated vendor libraries to latest
    • Rollback redirect_default_route logic as it has issues with multi-lang #2459
    • Fix potential issue with |contains Twig filter on PHP 7.3
    • Fixed bug in text field filtering: return empty string if value isn't a string or number #2460
    • Force Asset priority to be an integer and not throw error if invalid string passed #2461
    • Fixed bug in text field filtering: return empty string if value isn't a string or number
    • Fixed FlexForm missing getter methods for defining form variables



    • Backwards compatiblity with old Uri::__toString() output



    • Improved redirect_default_route logic as well as Uri::toArray() to take into account root_path and extension
    • Rework logic to pull out excluded files from pipeline more reliably #2445
    • Better logic in Utils::normalizePath to handle externals properly #2216
    • Fixed to force all Page::taxonomy to be treated as strings #2446
    • Fixed issue with Grav['user'] not being available form#332
    • Updated rounding logic for Utils::parseSize() #2394
    • Fixed Flex simple storage not being properly initialized if used with caching



    • Added Blueprint::addDynamicHandler() method to allow custom dynamic handlers, for example custom-options@: getCustomOptions
    • Missed a CacheCommand reference in bin/grav #2442
    • Fixed issue with Utils::normalizePath messing with external URLs #2216
    • Fix for vUndefined versions when upgrading



    • Revert renaming of ClearCacheCommand to ensure CLI GPM upgrades go smoothly



    • Improved CSS for the bottom filter bar of DebugBar
    • Fixed issue with @import not being added to top of pipelined css #2440



    • Set minimum requirements to PHP 7.1.3
    • New Scheduler functionality for periodic jobs
    • New Backup functionality with multiple backup profiles and scheduler integration
    • Refactored Assets Manager to be more powerful and flexible
    • Updated Doctrine Collections to 1.6
    • Updated Doctrine Cache to 1.8
    • Updated Symfony Components to 4.2
    • Added new Cache purge functionality old cache manually via CLI/Admin as well as scheduler integration
    • Added new {% throw 404 'Not Found' %} twig tag (with custom code/message)
    • Added Grav\Framework\File classes for handling YAML, Markdown, JSON, INI and PHP serialized files
    • Added Grav\Framework\Collection\AbstractIndexCollection class
    • Added Grav\Framework\Object\ObjectIndex class
    • Added Grav\Framework\Flex classes
    • Added support for hiding form fields in blueprints by using dynamic property like security@: admin.foobar, scope@: object or scope-ignore@: object to any field
    • New experimental FlexObjects powered Users for increased performance and capability (disabled by default)
    • Added PSR-7 and PSR-15 classes
    • Added Grav\Framework\DI\Container class
    • Added Grav\Framework\RequestHandler\RequestHandler class
    • Added Page::httpResponseCode() and Page::httpHeaders() methods
    • Added Grav\Framework\Form\Interfaces\FormInterface
    • Added Grav\Framework\Form\Interfaces\FormFactoryInterface
    • Added Grav\Framework\Form\FormTrait
    • Added Page::forms() method to get normalized list of all form headers defined in the page
    • Added onPageAction, onPageTask, onPageAction.{$action} and onPageTask.{$task} events
    • Added Blueprint::processForm() method to filter form inputs
    • Move processMarkdown() method from TwigExtension to more general Utils class
    • Added support to include extra files into Media (such as uploaded files)
    • Added form preview support for FlexObject, including a way to render newly uploaded files before saving them
    • Added FlexObject::getChanges() to determine what fields change during an update
    • Added arrayDiffMultidimensional, arrayIsAssociative, arrayCombine Util functions
    • New $grav['users'] service to allow custom user classes implementing UserInterface
    • Added LogViewer helper class and CLI command: bin/grav logviewer
    • Added select() and unselect() methods to CollectionInterface and its base classes
    • Added orderBy() and limit() methods to ObjectCollectionInterface and its base classes
    • Added user-data:// which is a writable stream (user://data is not and should be avoided)
    • Added support for /action:{$action} (like task but used without nonce when only receiving data)
    • Added onAction.{$action} event
    • Added Grav\Framework\Form\FormFlash class to contain AJAX uploaded files in more reliable way
    • Added Grav\Framework\Form\FormFlashFile class which implements UploadedFileInterface from PSR-7
    • Added Grav\Framework\Filesystem\Filesystem class with methods to manipulate stream URLs
    • Added new $grav['filesystem'] service using an instance of the new Filesystem object
    • Added {% render object layout: 'default' with { variable: true } %} for Flex objects and collections
    • Added $grav->setup() to simplify CLI and custom access points
    • Added CsvFormatter and CsvFile classes
    • Added new system config option to pages.hide_empty_folders if a folder has no valid .md file available. Default behavior is false for compatibility.
    • Added new system config option for languages.pages_fallback_only forcing only 'fallback' to find page content through supported languages, default behavior is to display any language found if active language is missing
    • Added Utils::arrayFlattenDotNotation() and Utils::arrayUnflattenDotNotation() helper methods
    • Add the page to onMarkdownInitialized event #2412
    • Doctrine filecache is now namespaced with prefix to support purging
    • Register all page types into blueprint://pages stream
    • Removed apc and xcache support, made apc alias of apcu
    • Support admin and regular translations via the |t twig filter and t() twig function
    • Improved Grav Core installer/updater to run installer script
    • Updated vendor libraries including Symfony 4.2.3
    • Renamed old User class to Grav\Common\User\DataUser\User with multiple improvements and small fixes
    • User class now acts as a compatibility layer to older versions of Grav
    • Deprecated new User(), User::load(), User::find() and User::delete() in favor of $grav['users'] service
    • Media constructor has now support to not to initialize the media objects
    • Cleanly handle session corruption due to changing Flex object types
    • Added FlexObjectInterface::getDefaultValue() and FormInterface::getDefaultValue()
    • Added new onPageContent() event for every call to Page::content()
    • Added phpstan: PHP Static Analysis Tool #2393
    • Added composer test-plugins to test plugin issues with the current version of Grav
    • Added Flex::getObjects() and Flex::getMixedCollection() methods for co-mingled collections
    • Added support to use single Flex key parameter in Flex::getObject() method
    • Added FlexObjectInterface::search() and FlexCollectionInterface::search() methods
    • Override with PHP's post_max_size or upload_max_filesize
    • Class Grav\Common\Page\Medium\AbstractMedia now use array traits instead of extending Grav\Common\Getters
    • Implemented Grav\Framework\Psr7 classes as Nyholm/psr7 decorators
    • Added a new cache-clear scheduled job to go along with cache-purge
    • Renamed Grav\Framework\File\Formatter\FormatterInterface to Grav\Framework\File\Interfaces\FileFormatterInterface
    • Improved File::save() to use a temporary file if file isn't locked
    • Improved |t filter to better support admin |tu style filter if in admin
    • Update all classes to rely on PageInterface instead of Page class
    • Better error checking in bin/plugin for existence and enabled
    • Removed media.upload_limit references
    • Twig nicenumber: do not use 0 + string casting hack
    • Converted Twig tags to use namespaced Twig classes
    • Site shows error on page rather than hard-crash when page has invalid frontmatter #2343
    • Added languages.default_lang option to override the default lang (usually first supported language)
    • Added Content-Type: application/json body support for PSR-7 ServerRequest
    • Remove PHP time limit in ZipArchive
    • DebugBar: Resolve twig templates in deprecated backtraces in order to help locating Twig issues
    • Added $grav['cache']->getSimpleCache() method for getting PSR-16 compatible cache
    • MediaTrait: Use PSR-16 cache
    • Improved Utils::normalizePath() to support non-protocol URLs
    • Added ability to reset Page::metadata to allow rebuilding from automatically generated values
    • Added back missing page.types field in system content configuration admin#1612
    • Console commands: add method for invalidating cache
    • Updated languages
    • Improved $page->forms() call, added $page->addForms()
    • Updated languages from crowdin
    • Fixed ImageMedium constructor warning when file does not exist
    • Improved Grav\Common\User class; added $user->update() method
    • Added trim support for text input fields validate: trim: true
    • Improved Grav\Framework\File\Formatter classes to have abstract parent class and some useful methods
    • Support negotiated content types set via the Request Accept: header
    • Support negotiated language types set via the Request Accept-Language: header
    • Cleaned up and sorted the Service idMap
    • Updated Grav container object to implement PSR-11 ContainerInterface
    • Updated Grav Processor classes to implement PSR-15 MiddlewareInterface
    • Make Data class to extend JsonSerializable
    • Modified debugger icon to use retina space-dude version
    • Added missing Video::preload() method
    • Set session name based on security.salt rather than GRAV_ROOT #2242
    • Added option to configure list of xss_invalid_protocols in Security config #2250
    • Smarter security.salt checking now we use security.yaml for other options
    • Added apcu autoloader optimization
    • Additional helper methods in Language, Languages, and LanguageCodes classes
    • Call onFatalException event also on internal PHP errors
    • Built-in PHP Webserver: log requests before handling them
    • Added support for syslog and syslog facility logging (default: 'file')
    • Improved usability of System configuration blueprint with side-tabs
    • Fixed issue with Truncator::truncateWords and Truncator::truncateLetters when string not wrapped in tags #2432
    • Fixed Undefined method closure::fields() when getting avatar for user, thanks @Romarain #2422
    • Fixed cached images not being updated when source image is modified
    • Fixed deleting last list item in the form
    • Fixed issue with Utils::url() method would append extra base_url if URL already included it
    • Fixed mkdir(...) race condition
    • Fixed Obtaining write lock failed on file...
    • Fixed potential undefined property in onPageNotFound event handling
    • Fixed some potential issues/bugs found by phpstan
    • Fixed regression in GPM packages casted to Array (ref, getgrav/grav-plugin-admin@e3fc4ce)
    • Fixed session_start(): Setting option '' failed #2408
    • Fixed validation for select field type with selectize
    • Fixed validation for boolean toggles
    • Fixed non-namespaced exceptions in scheduler
    • Fixed trailing slash redirect in multlang environment #2350
    • Fixed some issues related to Medium objects losing query string attributes
    • Broke out Medium timestamp so it's not cleared on reset()s
    • Fixed issue with redirect_trailing_slash losing query string #2269
    • Fixed failed login if user attempts to log in with upper case non-english letters
    • Removed extra authenticated/authorized fields when saving existing user from a form
    • Fixed Grav\Framework\Route::__toString() returning relative URL, not relative route
    • Fixed handling of append_url_extension inside of Page::templateFormat() #2264
    • Fixed a broken language string #2261
    • Fixed clearing cache having no effect on Doctrine cache
    • Fixed Medium::relativePath() for streams
    • Fixed Object serialization breaking if overriding jsonSerialize() method
    • Fixed YamlFormatter::decode() when calling init_set() with integer
    • Fixed session throwing error in CLI if initialized
    • Fixed Uri::hasStandardPort() to support reverse proxy configurations #1786
    • Use append_url_extension from page header to set template format if set #2604
    • Fixed some bugs in Grav environment selection logic
    • Use login provider User avatar if set
    • Fixed Folder::doDelete($folder, false) removing symlink when it should not
    • Fixed asset manager to not add empty assets when they don't exist in the filesystem
    • Update script and style Twig tags to use the new Assets classes
    • Fixed asset pipeline to rewrite remote URLs as well as local #2216



    • Added new deferred Twig extension



    • Added new onPageContent() event for every call to Page::content()
    • Fixed phpdoc generation
    • Updated vendor libraries
    • Force Toolbox v1.4.2
    • EXIF fix for streams
    • Fix for User avatar not working due to uppercase or spaces in email #2403



    • Improved User unserialize to not to break the object if serialized data is not what expected
    • Removed unused parameter #2357



    • Support for AWS Cloudfront forwarded scheme header #2297
    • Set homepage with https:// protocol #2299
    • Preserve accents in fields containing Twig expr. using unicode #2279
    • Updated vendor libraries
    • Support spaces with filenames in responsive images #2300



    • Updated InitializeProcessor.php to use lang-safe redirect #2268
    • Improved user serialization to use less memory in the session



    • Register theme prefixes as namespaces in Twig #2210
    • Propogate error code between 400 and 600 for production sites #2181
    • Remove hardcoded 302 when redirecting trailing slash #2155



    • Updated default page with some consistency fixes #2245
    • Fixed fatal error if calling $session->invalidate() when there's no active session
    • Fixed typo in media.yaml for webm extension #2220
    • Fixed markdown processing for telephone links #2235



    • Added Utils::getMimeByFilename(), Utils::getMimeByLocalFile() and Utils::checkFilename() methods
    • Added configurable dangerous upload extensions in security.yaml
    • Updated vendor libraries to latest



    • Added new Security class for Grav security functionality including XSS checks
    • Added new bin/grav security command to scan for security issues
    • Added new xss() Twig function to allow for XSS checks on strings and arrays
    • Added onHttpPostFilter event to allow plugins to globally clean up XSS in the forms and tasks
    • Added Deprecated tab to DebugBar to catch future incompatibilities with later Grav versions
    • Added deprecation notices for features which will be removed in Grav 2.0
    • Updated vendor libraries to latest
    • Allow $page->slug() to be called before $page->init() without breaking the page
    • Fix for Page::translatedLanguages() to use routes always #2163
    • Fixed nicetime() twig function
    • Allow twig tags {% script %}, {% style %} and {% switch %} to be placed outside of blocks
    • Session expires in 30 mins independent from config settings login#178



    • Added static Grav\Common\Yaml class which should be used instead of Symfony\Component\Yaml\Yaml
    • Updated deprecated Twig code so it works in both in Twig 1.34+ and Twig 2.4+
    • Switched to new Grav Yaml class to support Native + Fallback YAML libraries
    • Broken handling of user folder in Grav URI object #2151



    • Set minimum requirements to PHP 5.6.4
    • Updated Doctrine Collections to 1.4
    • Updated Symfony Components to 3.4 (with compatibility mode to fall back to Symfony YAML 2.8)
    • Added Uri::method() to get current HTTP method (GET/POST etc)
    • FormatterInterface: Added getSupportedFileExtensions() and getDefaultFileExtension() methods
    • Added option to disable SimpleCache key validation
    • Added support for multiple repo locations for bin/grav install command
    • Added twig filters for casting values: |string, |int, |bool, |float, |array
    • Made ObjectCollection::matching() criteria expressions to behave more like in Twig
    • Criteria: Added support for LENGTH(), LOWER(), UPPER(), LTRIM(), RTRIM() and TRIM()
    • Added Grav\Framework\File\Formatter classes for encoding/decoding YAML, Markdown, JSON, INI and PHP serialized strings
    • Added Grav\Framework\Session class to replace RocketTheme\Toolbox\Session\Session
    • Added Grav\Common\Media interfaces and trait; use those in Page and Media classes
    • Added Grav\Common\Page interface to allow custom page types in the future
    • Added setting to disable sessions from the site #2013
    • Added new strict_mode settings in system.yaml for compatibility
    • Improved Utils::url() to support query strings
    • Display better exception message if Grav fails to initialize
    • Added muted and playsinline support to videos #2124
    • Added MediaTrait::clearMediaCache() to allow cache to be cleared
    • Added MediaTrait::getMediaCache() to allow custom caching
    • Improved session handling, allow all session configuration options in system.session.options
    • Fix broken form nonce logic #2121
    • Fixed issue with uppercase extensions and fallback media URLs #2133
    • Fixed theme inheritance issue with camel-case that includes numbers #2134
    • Typo in demo typography page #2136
    • Fix for incorrect plugin order in debugger panel
    • Made |markdown filter HTML safe
    • Fixed bug in ContentBlock serialization
    • Fixed Route::withQueryParam() to accept array values
    • Fixed typo in truncate function #1943
    • Fixed blueprint field validation: Allow numeric inputs in text fields



    • Add Grav version to debug bar messages tab #2106
    • Add Nginx config for ddev project to webserver-configs #2117
    • Vendor library updates
    • Don't allow null to be set as Page content



    • Use getFilename instead of getBasename #2087
    • Fix for modular page preview #2066
    • Page::routeCanonical() should be string not array #2069



    • Manually re-added the improved SSL off-loading that was lost with Grav v1.4.0 merge #1888
    • Handle multibyte strings in truncateLetters() #2007
    • Updated robots.txt to include /user/images/ folder #2043
    • Add getter methods for original and action to the Page object #2005
    • Modular template extension follows the master page extension #2044
    • Vendor library updates
    • Handle errors.display system property better in admin plugin admin#1452
    • Fix classes on non-http based protocol links #2034
    • Fixed crash on IIS (Windows) with open_basedir in effect #2053
    • Fixed incorrect routing with setup.php based base #1892
    • Fixed image resource memory deallocation #2045
    • Fixed issue with Errors display: option not handling integers properly admin#1452



    • Fixed an issue with some users getting 2FA prompt after upgrade admin#1442
    • Do not crash when generating URLs with arrays as parameters #2018
    • Utils::truncateHTML removes whitespace when generating summaries #2004



    • Added support for Uri::post() and Uri::getConentType()
    • Added a new Medium:thumbnailExists() function #1966
    • Added authorized support for 2FA
    • Added default configuration for images #1979
    • Added dedicated PHPUnit assertions #1990
    • Use array_key_exists instead of in_array + array_keys #1991
    • Fixed an issue with custom_base_url always causing 404 errors
    • Improve support for regex redirects with query and params #1983
    • Changed collection-based date sorting to SORT_REGULAR for better server compatibility #1910
    • Fix hardcoded string in modular blueprint #1933



    • moved Twig sortArrayByKey logic into Utils:: class
    • Rolled back Parsedown library to stable 1.6.4 until a better solution for 1.8.0 compatibility can fe found
    • Updated vendor libraries to latest versions
    • Fix for bad reference to ZipArchive in GPM::Installer



    • Added new |nicefilesize Twig filter for pretty file (auto converts to bytes, kB, MB, GB, etc)
    • Added new regex_filter() Twig function to values in arrays
    • Added bosnian to lang codes #1917
    • Improved Zip extraction error codes #1922
    • Fixed an issue with Markdown Video and Audio that broke after Parsedown 1.7.0 Security updates #1924
    • Fix for case-sensitive page metadata admin#1370
    • Fixed missing composer requirements for the new Grav\Framework\Uri classes
    • Added missing PSR-7 vendor library required for URI additions in Grav 1.4.0



    • Fixed session timing out because of session cookie was not being sent



    • Added Grav\Framework\Uri classes extending PSR-7 HTTP message UriInterface implementation
    • Added Grav\Framework\Route classes to allow route/link manipulation
    • Added $grav['uri]->getCurrentUri() method to get Grav\Framework\Uri\Uri instance for the current URL
    • Added $grav['uri]->getCurrentRoute() method to get Grav\Framework\Route\Route instance for the current URL
    • Added ability to have php version dependencies in GPM assets
    • Added new {% switch %} twig tag for more elegant if statements
    • Added new {% markdown %} twig tag
    • Added Route Overrides to the default page blueprint
    • Added new Collection::toExtendedArray() method that's particularly useful for Json output of data
    • Added new |yaml_encode and |yaml_decode Twig filter to convert to and from YAML
    • Added new read_file() Twig function to allow you to load and display a file in Twig (Supports streams and regular paths)
    • Added a new Medium::exists() method to check for file existence
    • Moved Twig urlFunc() to Utils::url() as its so darn handy
    • Transferred overall copyright from RocketTheme, LLC, to Trilby Media LLC
    • Added theme_var, header_var and body_class Twig functions for themes
    • Added Grav\Framework\Cache classes providing PSR-16 Simple Cache implementation
    • Added Grav\Framework\ContentBlock classes for nested HTML blocks with CSS/JS assets
    • Added Grav\Framework\Object classes for creating collections of objects
    • Added |nicenumber Twig filter
    • Added {% try %} ... {% catch %} Error: {{ e.message }} {% endcatch %} tag to allow basic exception handling inside Twig
    • Added {% script %} and {% style %} tags for Twig templates
    • Deprecated GravTrait
    • Improved Session initialization
    • Added ability to set a theme_var() option in page frontmatter
    • Force clearing PHP clearstatcache and opcache-reset on Cache::clear()
    • Better Page.collection() filtering support including ability to have non-published pages in collections
    • Stopped Chrome from auto-completing admin user profile form #1847
    • Support for empty switch field like a checkbox
    • Made modular blueprint more flexible
    • Code optimizations to Utils class #1830
    • Objects: Add protected function getElement() to get serialized value for a single property
    • ObjectPropertyTrait: Added protected functions isPropertyLoaded(), offsetLoad(), offsetPrepare() and offsetSerialize()
    • Grav\Framework\Cache: Allow unlimited TTL
    • Optimizations & refactoring to the test suite #1779
    • Slight modification of Whoops error colors
    • Added new configuration option system.session.initialize to delay session initialization if needed by a plugin
    • Updated vendor libraries to latest versions
    • Removed constructor from ObjectInterface
    • Make it possible to include debug bar also into non-HTML responses
    • Updated built-in JQuery to latest 3.3.1
    • Fixed issue with image alt tag always getting empted out unless set in markdown
    • Fixed issue with remote PHP version determination for Grav updates #1883
    • Fixed issue with illegal scheme offset in Uri::convertUrl() page-inject#8
    • Properly validate YAML blueprint fields so admin can save as proper YAML now [addresses many issues]
    • Fixed OpenGraph metatags so only Twitter uses name=, and all others use property= #1849
    • Fixed an issue with evaluate() and evaluate_twig() Twig functions that throws invalid template error
    • Fixed issue with |sort_by_key twig filter if the input was null or not an array
    • Date ordering should always be numeric #1810
    • Fix for base paths containing special characters #1799
    • Fix for session cookies in paths containing special characters
    • Fix for vundefined error for version numbers in GPM form#222
    • Fixed BadMethodCallException thrown in GPM updates #1784
    • NOTE: Parsedown security release now escapes & to & in Markdown links



    • Reverted GPM Local pull request as it broken admin #1742



    • Added new core Twig templates for partials/metadata.html.twig and partials/messages.html.twig
    • Added ability to work with GPM locally #1742
    • Added new HTML5 audio controls #1756
    • Added Medium::copy() method to create a copy of a medium object
    • Added new force_lowercase_urls functionality on routes and slugs
    • Added new item-list filter type to remove empty items
    • Added new setFlashCookieObject() and getFlashCookieObject() methods to Session object
    • Added new intl_enabled option to disable PHP intl module collation when not needed
    • Fixed an issue with checkbox field validation form#216
    • Fixed issue with multibyte Markdown link URLs #1749
    • Fixed issue with multibyte folder names #1751
    • Fixed several issues related to system.custom_base_url that were broken #1736
    • Dynamically added pages via Pages::addPage() were not firing onPageProcessed() event causing forms not to be processed
    • Fixed Page::active() and Page::activeChild() to work with UTF-8 characters in the URL #1727
    • Fixed typo in modular.yaml causing media to be ignored #1725
    • Reverted case_insensitive_urls option as it was causing issues with taxonomy #1733
    • Removed an extra / in CompileFile.php #1693
    • Uri::Encode user and password to prevent issues in browsers
    • Fixed "Invalid AJAX response" When using Built-in PHP Webserver in Windows #1258
    • Remove support for config.user, it was broken and bad practise
    • Make sure that clean cache uses valid path #1745
    • Fixed token creation issue with Uri params like /id:3
    • Fixed CSS Pipeline failing with Google remote fonts if the file was minified #1261
    • Forced field.multiple: true to allow use of min/max options in checkboxes.validate



    • Added Page media_order capability to manually order page media via a page header
    • Fixed GPM update issue with filtered slugs #1711
    • Fixed issue with missing image file not throwing 404 properly #1713



    • Regression Uri: base_url_absolute always has the port number #1690
    • Uri: Prefer using REQUEST_SCHEME instead of HTTPS #1698
    • Fixed routing paths with urlencoded spaces and non-latin letters #1688



    • Regression: Ajax error in Nginx admin#1244
    • Remove the _url=$uri portion of the the Nginx try_files command admin#1244



    • Refactored URI class with numerous bug fixes, and optimizations
    • Override with PHP's post_max_size or upload_max_filesize
    • Updated bin/grav clean command to remove unnecessary vendor files (save some bytes)
    • Added a http_status_code Twig function to allow setting HTTP status codes from Twig directly.
    • Deter XSS attacks via URI path/uri methods (credit:newbthenewbd)
    • Added support for $uri->toArray() and (string)$uri
    • Added support for type on Asstes::addInlineJs() #1683
    • Fixed method signature error with GPM\InstallCommand::processPackage() #1682



    • Added filter support for Page collections (routable/visible/type/access/etc.)
    • Implemented Composer\CaBundle for SSL Certs #1241
    • Refactored the Assets sorting logic
    • Improved language overrides to merge only 'extra' translations #1514
    • Improved support for Assets with query strings #1451
    • Twig extension cleanup
    • Fixed an issue where fallback was not supporting dynamic page generation
    • Fixed issue with Image query string not being fully URL encoded #1622
    • Fixed Page::summary() when using delimiter and multibyte UTF8 Characters #1644
    • Fixed missing .json thumbnail throwing error when adding media grav-plugin-admin#1156
    • Fixed insecure session cookie initialization #1656



    • Added support for 2-Factor Authentication in admin profile
    • Added gaussianBlur media method #1623
    • Added new |chunk_split(), |basename, and |dirname Twig filter
    • Added new tl Twig filter/function to support specific translations #1618
    • User authorization now requires a check for authenticated - REQUIRED: Login v2.4.0
    • Added options to Page::summary() to support size without HTML tags #1554
    • Forced natsort on plugins to ensure consistent plugin load ordering across platforms #1614
    • Use new multilevel field to handle Asset Collections #1201
    • Added support for redis password option #1620
    • Use 302 rather than 301 redirects by default #1619
    • GPM Installer will try to load alphanumeric version of the class if no standard class found #1630
    • Add current page position to User class #1632
    • Added option to enable case insensitive URLs #1638
    • Updated vendor libraries
    • Updated travis.yml to add support for PHP 7.1 as well as 7.0.21 for test suite
    • Fixed UTF8 multibyte UTF8 character support in Page::summary() #1554



    • Added a new cache_control system and page level property #1591
    • Added a new clear_images_by_default system property to stop cache clear events from removing processed images #1481
    • Added new onTwigLoader() event to enable utilization of loader methods
    • Added new Twig::addPath() and Twig::prependPath() methods to wrap loader methods and support namespacing #1604
    • Added new array_key_exists() Twig function wrapper
    • Added a new Collection::intersect() method #1605
    • Allow session.timeout field to be set to 0 via blueprints #1598
    • Fixed Data::exists() and Data::raw() functions breaking if Data::file() hasn't been called with non-null value
    • Fixed parent theme auto-loading in child themes of Gantry 5



    • Fix ordering for Linux + International environments #1574
    • Check if medium thumbnail exists before resetting
    • Update Travis' auth token





    • Setting system.session.timeout to 0 clears the session when the browser session ends #1538
    • Created a so everyone knows how to behave :)
    • Renamed new media() Twig function to media_directory() to avoid conflict with Page's media object
    • Fixed global media files disappearing after a reload #1545
    • Fix for broken regex redirects/routes via site.yaml
    • Sanitize the error message in the error handler page



    • Added lower and upper Twig filters
    • Added pathinfo() Twig function
    • Added 165 new thumbnail images for use in media.yaml
    • Improved error message when running bin/grav install instead of bin/gpm install, and also when running on a non-skeleton site #1027
    • Updated vendor libraries
    • Don't rebuild metadata every time, only when file does not exist
    • Restore GravTrait in ConsoleTrait grav-plugin-login#119
    • Fix Windows routing with built-in server #1502
    • Fix #1504 process_twig and frontmatter.yaml
    • Nicetime fix: 0 seconds from now -> just now #1509



    • Added new unified Utils::getPagePathFromToken() method which is used by various plugins (Admin, Forms, Downloads, etc.)
    • Optionally remove unpublished pages from the translated languages, move into untranslated list #1482
    • Improved reliability of hash file-check method
    • Updated to latest Toolbox library to fix issue with some blueprints rendering in admin plugin #1117
    • Fix output handling in RenderProcessor #1483



    • Added new media and vardump Twig functions
    • Put in various checks to ensure Exif is available before trying to use it
    • Add timestamp to configuration settings #1445
    • Fix an issue saving YAML textarea fields in expert mode #1480
    • Moved onOutputRendered() back into Grav core



    • Added support for a single array field in the forms
    • Added EXIF support with automatic generation of Page Media metafiles
    • Added Twig function to get EXIF data on any image file
    • Added Pages::baseUrl(), Pages::homeUrl() and Pages::url() functions
    • Added base32_encode, base32_decode, base64_encode, base64_decode Twig filters
    • Added Debugger::getCaller() to figure out where the method was called from
    • Added support for custom output providers like Slim Framework
    • Added Grav\Framework\Collection classes for creating collections
    • Add more controls over HTML5 video attributes (autoplay, poster, loop controls) #1442
    • Removed logging statement for invalid slug #1459
    • Groups selection pre-filled in user form
    • Improve error handling in Folder::move()
    • Added extra parameter for Twig::processSite() to include custom context
    • Updated RocketTheme Toolbox vendor library
    • Fix to force route/redirect matching from the start of the route by default #1446
    • Edit check for valid slug #1459



    • Added optional ignores for Installer::sophisticatedInstall() #1447
    • Allow multiple calls to Themes::initTheme() without throwing errors
    • Fixed querystrings in root pages with multi-lang enabled #1436
    • Allow support for Pages::getList() with show_modular option #1080



    • Added new pwd_regex and username_regex system configuration options to allow format modifications
    • Allow user/accounts.yaml overrides and implemented more robust theme initialization
    • improved getList() method to do more powerful things
    • Fix Typo in GPM #1427



    • Fix for redirects breaking #1420
    • Fix issue in direct-install with github-style dependencies #1405



    • Added various ancestor helper methods in Page and Pages classes #1362
    • Added new parents field and switched Page blueprints to use this
    • Added isajaxrequest() Twig function #1400
    • Added ability to inline CSS and JS code via Asset manager #1377
    • Add query string in lighttpd default config #1393
    • Add --all-yes and --destination options for bin/gpm direct-install #1397
    • Fix for direct-install of plugins with languages.yaml #1396
    • When determining language from HTTP_ACCEPT_LANGUAGE, also try base language only #1402
    • Fixed a bad method signature causing warning when running tests on GPMTest object



    • Added file upload for user avatar in user/admin blueprint
    • Analysis fixes
    • Switched to stable composer lib versions



    • Refactored Page re-ordering to handle all siblings at once
    • Added language_codes to Twig init to allow for easy language name/code/native-name lookup
    • Added an Admin Overrides section with option to choose the order of children in Pages Management
    • Fixed loading issues with improperly named themes (use old broken method first) #1373
    • Simplified modular/twig processing logic and fixed an issue with system process config #1351
    • Cleanup package files via GPM install to make them more windows-friendly #1361
    • Fix for page-level debugger override changing the option site-wide
    • Allow url() twig function to pass-through external links



    • Updated vendor libraries to latest
    • Added the ability to disable debugger on a per-page basis with debugger: false in page frontmatter
    • Fixed an issue with theme inheritance and hyphenated base themes #1353
    • Fixed an issue when trying to use an @2x derivative on a non-image media file #1341



    • Added default setting to only allow direct-installs from official GPM. Can be configured in system.yaml
    • Added a new Utils::isValidUrl() method
    • Added optional parameter to |markdown(false) filter to toggle block/line processing (default|true = block)
    • Added new Page::folderExists() method
    • Twig::evaluate() now takes current environment and context into account
    • Genericized direct-install so it can be called via Admin plugin
    • Fixed a minor bug in Number validation #1329
    • Fixed exception when trying to find user account and there is no user://accounts folder
    • Fixed issue when setting Page::expires(0) Admin #1009
    • Removed ID from nonce_field() Twig function causing validation errors Form #115



    • Fix for double extensions getting added during some redirects #1307
    • Fix syntax error in PHP 5.3. Move the version check before requiring the autoloaded deps
    • Fix Whoops displaying error page if there is PHP core warning or error Admin #980



    • Exposed the Pages cache ID for use by plugins (e.g. Form) via Pages::getPagesCacheId()
    • Added Languages::resetFallbackPageExtensions() regarding #1276
    • Allowed CLI to use non-volatile cache drivers for better integration with CLI and Web caches
    • Added Gantry5-compatible query information to Caddy configuration
    • Added some missing docblocks and type-hints
    • Various code cleanups (return types, missing variables in doclbocks, etc.)



    • Added a new Collection::merge() method to allow merging of multiple collections #1258
    • Added OpenCollective backer/sponsor info to
    • Add an additional parameter to GPM::findPackage to avoid throwing an exception, for use in Twig #1008
    • Skip symlinks if found while clearing cache #1269
    • Fixed an issue when page collection with header-based returns an array #1264
    • Fix Response object to handle 303 redirects when open_basedir in effect #1267
    • Silence E_WARNING: Zend OPcache API is restricted by "restrict_api" configuration directive



    • Fixed Page::collection() returning array and not Collection object when header variable did not exist
    • Revert Content-Encoding: identity fix, and let you set cache: allow_webserver_gzip: option to switch to identity #548



    • Added new never_cache_twig page option in system.yaml and frontmatter. Allows dynamic Twig logic in regular and modular Twig templates #1244
    • Several improvements to aid theme development #232
    • Added hash cache check option and made dropdown more descriptive Admin #923
    • Fixed cross volume file system operations #635
    • Fix issue with pages folders validation not accepting uppercase letters
    • Fix renaming the folder name if the page, in the default language, had a custom slug set in its header
    • Fixed issue with Content-Encoding: none. It should really be Content-Encoding: identity instead
    • Fixed broken hash method on page modifications detection
    • Fixed issue with multi-lang pages not caching independently without unique .md file #1211
    • Fixed all $_GET parameters missing in Nginx (please update your nginx.conf) #1245
    • Fixed issue in trying to process broken symlink #1254



    • Fixed issue with JSON calls throwing errors due to debugger enabled #1227



    • Fall back properly to HTML if template type not found
    • Fix issue with modular pages folders validation #900



    • Improve detection of home path. Also allow ~/.grav on Windows, drop ConsoleTrait::isWindows() method, used only for that #1204
    • Reworked PHP CLI router #1219
    • More robust theme/plugin logic in bin/gpm direct-install
    • Fixed case where extracting a package would cause an error during rename
    • Fix issue with using Yaml::parse direcly on a filename, now deprecated
    • Add pattern for frontend validation of folder slugs #891
    • Fix issue with Inflector when translation is disabled SimpleSearch #87
    • Explicitly expose array_unique Twig filter Admin #897



    • RC released as stable
    • Better error handling in cache clear
    • YAML syntax fixes for the future compatibility
    • Added new parameter remove for onBeforeCacheClear event
    • Add support for calling Media object as function to get medium by filename
    • Added checks before accessing admin reference during Page::blueprints() call. Allows to access page.blueprints from Twig in the frontend



    • Add ignore_empty property to be used on array fields, if positive only save options with a value
    • Use new permissions field in user account
    • Add range(int start, int end, int step) twig function to generate an array of numbers between start and end, inclusive
    • New retina Media image derivatives array support (![](image.jpg?derivatives=[640,1024,1440])) #1147
    • Added stream support for images (![Sepia Image](image://image.jpg?sepia))
    • Added stream support for links ([Download PDF](user://data/pdf/my.pdf))
    • Added new onBeforeCacheClear event to add custom paths to cache clearing process
    • Added alias selfupdate to the self-upgrade bin/gpm CLI command
    • Synced webserver-configs/htaccess.txt with .htaccess
    • Use permissions field in group details.
    • Updated vendor libraries
    • Added a warning on GPM update to update Grav first if needed #1194
    • Fix page collections problem with @page.modular #1178
    • Fix issue with using a multiple taxonomy filter of which one had no results, thanks to @hughbris #1184
    • Fix saving permissions in group
    • Fixed issue with redirect of a page getting moved to a different location



    • Added two new sort order options for pages: publish_date and unpublish_date #1173)
    • Multisite: Create image cache folder if it doesn't exist
    • Add 2 new language values for French #1174
    • Fixed issue when we have a meta file without corresponding media #1179
    • Update class namespace for Admin class Admin #874



    • Added a CompiledJsonFile object to better handle Json files.
    • Added Base32 encode/decode class
    • Added a new User::find() method
    • Fixed an issue with site redirects/routes, not processing with extension (.html, .json, etc.)
    • Don't truncate HTML if content length is less than summary size #1125
    • Return max available number when calling random() on a collection passing an int > available items #1135
    • Use correct ratio when applying image filters to image alternatives #1147
    • Fixed URI path in multi-site when query parameters were used in front page



    • Fixed warning with unset ssl option when using GPM #1132



    • Improved the capabilities of Image derivatives #1107
    • Only pass verify_peer settings to cURL and fopen if the setting is disabled #1120



    • Added ability for Page to override the output format (html, xml, etc..) #1067
    • Added Utils::getExtensionByMime() and cleaned up Utils::getMimeByExtension + tests
    • Added a cache.check.method: 'hash' option in system.yaml that checks all files + dates inclusively
    • Include jQuery 3.x in the Grav assets
    • Added the option to automatically fix orientation on images based on their Exif data, by enabling system.images.auto_fix_orientation.
    • Add batch() function to Page Collection class
    • Added new cache.redis.socket setting that allow to pass a UNIX socket as redis server
    • It is now possible to opt-out of the SSL verification via the new system.gpm.verify_peer setting. This is sometimes necessary when receiving a "GPM Unable to Connect" error. More details in (#1053)
    • It is now possible to force the use of either curl or fopen as Response connection method, via the new system.gpm.method setting. By default this is set to 'auto' and gives priority to 'fopen' first, curl otherwise.
    • InstallCommand can now handle Licenses
    • Uses more helpful 1x, 2x, 3x, etc names in the Retina derivatives cache files.
    • Added new method Plugins::isPluginActiveAdmin() to check if plugin route is active in Admin plugin
    • Added new Cache::setEnabled and Cache::getEnabled to enable outside control of cache
    • Updated vendor libs including Twig 1.25.0
    • Avoid git ignoring any vendor folder in a Grav site subfolder (but still ignore the main vendor/ folder)
    • Added an option to get just a route back from Uri::convertUrl() function
    • Added option to control split session #1096
    • Added new verbosity levels to system.error.display to allow for system error messages #1091
    • Improved the API for Grav plugins to access the Parsedown parser directly #1062
    • Fixed missing progress method in the DirectInstall Command
    • Response class now handles better unsuccessful requests such as 404 and 401
    • Fixed saving of external page types Admin #789
    • Fixed issue deleting parent folder of folder with param_sep in the folder name admin #796
    • Fixed an issue with streams in bin/plugin
    • Fixed jpeg file format support in Media



    • Added new bin/gpm direct-install command to install local and remote zip archives
    • Refactored onPageNotFound event to fire after onPageInitialized
    • Follow symlinks in Folder::all()
    • Twig variable base_url now supports multi-site by path feature
    • Improved bin/plugin to list plugins with commands faster by limiting the depth of recursion
    • Quietly skip missing streams in Cache::clearCache()
    • Fix issue in calling page.summary when no content is present in a page
    • Fix for HUGE session timeouts #1050



    • Added new tmp folder at root. Accessible via stream tmp://. Can be cleared with bin/grav clear --tmp-only as well as --all.
    • Added support for RTL in LanguageCodes so you can determine if a language is RTL or not
    • Ability to set custom_base_url in system configuration
    • Added override and force options for Streams setup
    • Important vendor updates to provide PHP 7.1 beta support!
    • Added a Util::arrayFlatten() static function
    • Added support for 'external_url' page header to enable easier external URL based menu items
    • Improved the UI for CLI GPM Index view to use a table
    • Added @page.modular Collection type #988
    • Added support for self@, page@, taxonomy@, root@ Collection syntax for cleaner YAML compatibility
    • Improved GPM commands to allow for -y to automate yes responses and -o for update and selfupgrade to overwrite installations #985
    • Added randomization to safe_email Twig filter for greater security #998
    • Allow Utils::setDotNotation to merge data, rather than just set
    • Moved default Image::filter() to the save action to ensure they are applied last #984
    • Improved the Truncator code to be more reliable #1019
    • Moved media blueprints out of core (now in Admin plugin)
    • Removed 307 redirect code option as it is not well supported #743
    • Fixed issue with folders with name *.md are not confused with pages #995
    • Fixed an issue when filtering collections causing null key
    • Fix for invalid HTML when rendering GIF and Vector media #1001
    • Use pages.markdown.extra in the user's system.yaml #1007
    • Fix for Memcached connection #1020



    • Fix for lightbox media function throwing error #981



    • Allow forcing SSL by setting system.force_ssl (Force SSL in the Admin System Config) #899
    • Improved authorize Twig extension to accept a nested array of authorizations #948
    • Don't add timestamps on remote assets as it can cause conflicts
    • Grav now looks at types from media.yaml when retrieving page mime types #966
    • Added support for dumping exceptions in the Debugger
    • Fixed Folder::delete method to recursively remove files and folders and causing Upgrade to fail.
    • Fix #952 hyphenize the session name.
    • If no parent is set and siblings collection is called, return a new and empty collection grav-plugin-sitemap/issues/22
    • Prevent exception being thrown when calling the Collator constructor failed in a Windows environment with the Intl PHP Extension enabled #961
    • Fix for markdown images not properly rendering id attribute #956



    • Made paramsRegex() static to allow it to be called statically
    • Fixed backup when using very long site titles with invalid characters grav-plugin-admin#701
    • Fixed a typo in the webserver-configs/nginx.conf example



    • Added support for validation of multiple email in the type: email field grav-plugin-email#31
    • Unified PHP code header styling
    • Added 6 more languages and updated language codes
    • set default "releases" option to stable



    • Add a onPageFallBackUrl event when starting the fallbackUrl() method to allow the Login plugin to protect the page media
    • Conveniently allow ability to retrieve user information via config object #913 - @Vivalldi
    • Grav served images can now use header caching #905
    • Take asset modification timestamp into consideration in pipelining #917 - @Sommerregen
    • Respect enable_asset_timestamp settings for pipelined Assets #906
    • Fixed collections end dates for 32-bit systems #902
    • Fixed a recent regression (1.1.0-rc1) with parameter separator different than :



    • Added getters and setters for Assets to allow manipulation of CSS/JS/Collection based assets via plugins #876
    • Pass the exception to the onFatalException() event
    • Updated to latest jQuery 2.2.4 release
    • Moved list items in system/config/media.yaml config into a types: key which allows you delete default items.
    • Updated webserver-configs/nginx.conf with try_files fix from @mrhein and @rondlite #743
    • Updated cache references to include memecache and redis #887
    • Updated composer libraries
    • Fixed Utils::normalizePath() that was truncating 0's #882



    • Added Utils::getDotNotation() and Utils::setDotNotation() methods + tests
    • Added support for xx-XX locale language lookups in LanguageCodes class #854
    • New CSS/JS Minify library that does a more reliable job #864
    • GPM installation of plugins and themes into correct multisite folders #841
    • Use Page::rawRoute() in blueprints for more reliable mulit-language support
    • Fixes for zlib.output_compression as well as mod_deflate GZIP compression
    • Fix for corner-case redirect logic causing infinite loops and out-of-memory errors
    • Fix for saving fields in expert mode that have no Validation::typeX() methods #626
    • Detect if user really meant to extend parent blueprint, not another one (fixes old page type blueprints)
    • Fixed a bug in Page::relativePagePath() when Page::$name is not defined
    • Fix for poor handling of params + query element in Uri::processParams() #859
    • Fix for double encoding in markdown links #860
    • Correctly handle language strings to determine if it's in admin or not #627



    • Updated jQuery from 2.2.0 to 2.2.3
    • Set Uri::ip() to static by default so it can be used in form fields
    • Improved Session class with flash storage
    • Page::getContentMeta() now supports an optional key.
    • Fixed "Invalid slug set in YAML frontmatter" when setting Page::slug() with empty string #580
    • Only .gitignore Grav's vendor folder
    • Fix trying to remove Grav with GPM uninstall of a plugin with Grav dependency
    • Fix Page Type blueprints not being able to extend their parents
    • filterFile validation method always returns an array of files, behaving like multiple="multiple"
    • Fixed #835 check for empty image file first to prevent getimagesize() fatal error
    • Avoid throwing an error when Grav's Gzip and mod_deflate are enabled at the same time on a non php-fpm setup



    • Drop dependencies calculations if plugin is installed via symlink
    • Drop Grav from dependencies calculations
    • Send slug name as part of installed packages
    • Fix for summary entities not being properly decoded #825



    • Pass the Page type when calling onBlueprintCreated
    • Changed Page::cachePageContent() form private to public so a page can be recached via plugin
    • Fixed handling of {'loading':'async'} with Assets Pipeline
    • Fix for new modular page modal Page field requiring a value #529
    • Fix for broken bin/gpm version command
    • Fix handling "grav" as a dependency
    • Fix when installing multiple packages and one is the dependency of another, don't try to install it twice
    • Fix using name instead of the slug to determine a package folder. Broke for packages whose name was 2+ words



    • Added new Plugin::getBlueprint() and Theme::getBlueprint() method
    • Allow page blueprints to be added via Plugins.
    • Moved to new data-*@ format in blueprints
    • Updated composer-based libraries
    • Moved some hard-coded CACHE_DIR references to use locator
    • Set twig.debug: true by default
    • Fixed issue with link rewrites and local assets pipeline with absolute_urls: true
    • Allow Cyrillic slugs #520
    • Fix ordering issue with accented letters #784
    • Fix issue with Assets pipeline and missing newlines causing invalid JavaScript



    • Blueprint Improvements: The main improvements to Grav take the form of a major rewrite of our blueprint functionality. Blueprints are an essential piece of functionality within Grav that helps define configuration fields. These allow us to create a definition of a form field that can be rendered in the administrator plugin and allow the input, validation, and storage of values into the various configuration and page files that power Grav. Grav 1.0 had extensive support for building and extending blueprints, but Grav 1.1 takes this even further and adds improvements to our existing system.
    • Extending Blueprints: You could extend forms in Grav 1.0, but now you can use a newer extends@: default syntax rather than the previous '@extends' string that needed to be quoted in YAML. Also this new format allows for the defining of a context which lets you define where to look for the base blueprint. Another new feature is the ability to extend from multiple blueprints.
    • Embedding/Importing Blueprints: One feature that has been requested is the ability to embed or import one blueprint into another blueprint. This allows you to share fields or sub-form between multiple forms. This is accomplished via the import@ syntax.
    • Removing Existing Fields and Properties: Another new feature is the ability to remove completely existing fields or properties from an extended blueprint. This allows the user a lot more flexibility when creating custom forms by simply using the new unset@: true syntax. To remove a field property you would use unset-<property>@: true in your extended field definition, for example: unset-options@: true.
    • Replacing Existing Fields and Properties: Similar to removing, you can now replace an existing field or property with the replace@: true syntax for the whole field, and replace-<property>@: true for a specific property.
    • Field Ordering: Probably the most frequently requested blueprint functionality that we have added is the ability to change field ordering. Imagine that you want to extend the default page blueprint but add a new tab. Previously, this meant your tab would be added at the end of the form, but now you can define that you wish the new tab to be added right after the content tab. This works for any field too, so you can extend a blueprint and add your own custom fields anywhere you wish! This is accomplished by using the new ordering@: syntax with either an existing property name or an integer.
    • Configuration Properties: Another useful new feature is the ability to directly access Grav configuration in blueprints with config-<property>@ syntax. For example you can set a default for a field via config-default@: which will use the value from the site.yaml file as the default value for this field.
    • Function Calls: The ability to call PHP functions for values has been improved in Grav 1.1 to be more powerful. You can use the data-<property>@ syntax to call static methods to obtain values. For example: data-default@: '\Grav\Plugin\Admin::route'. You can now even pass parameters to these methods.
    • Validation Rules: You can now define a custom blueprint-level validation rule and assign this rule to a form field.
    • Custom Form Field Types: This advanced new functionality allows you to create a custom field type via a new plugin event called getFormFieldTypes(). This allows you to provide extra functionality or instructions on how to handle the form form field.
    • GPM Versioning: A new feature that we have wanted to add to our GPM package management system is the ability to control dependencies by version. We have opted to use a syntax very similar to the Composer Package Manager that is already familiar to most PHP developers. This new versioning system allows you to define specific minimum version requirements of dependent packages within Grav. This should ensure that we have less (hopefully none!) issues when you update one package that also requires a specific minimum version of another package. The admin plugin for example may have an update that requires a specific version of Grav itself.
    • GPM Testing Channel: GPM repository now comes with both a stable and testing channel. A new setting in system.gpm.releases allow to switch between the two channels. Developers will be able to decide whether their resource is going to be in a pre-release state or stable. Only users who switch to the testing channel will be able to install a pre-release version.
    • GPM Events: Packages (plugins and themes) can now add event handlers to hook in the package GPM events: install, update, uninstall. A package can listen for events before and after each of these events, and can execute any PHP code, and optionally halt the procedure or return a message.
    • Refactor of the process chain breaking out Processors into individual classes to allow for easier modification and addition. Thanks to toovy for this work. - #745
    • Added multipart downloads, resumable downloads, download throttling, and video streaming in the Utils::download() method.
    • Added optional config to allow Twig processing in page frontmatter - #788
    • Added the ability to provide blueprints via a plugin (previously limited to Themes only).
    • Added Developer CLI Tools to easily create a new theme or plugin
    • Allow authentication for proxies - #698
    • Allow to override the default Parsedown behavior - #747
    • Added an option to allow to exclude external files from the pipeline, and to render the pipeline before/after excluded files
    • Added the possibility to store translations of themes in separate files inside the languages folder
    • Added a method to the Uri class to return the base relative URL including the language prefix, or the base relative url if multilanguage is not enabled
    • Added a shortcut for pages.find() alias
    • Now supporting hostnames with localhost environments for better vhost support/development
    • Refactor hard-coded paths to use PHP Streams that allow a setup file to configure where certain parts of Grav are stored in the physical filesystem.
    • If multilanguage is active, include the Intl Twig Extension to allow translating dates automatically (
    • Allow having local themes with the same name as GPM themes, by adding gpm: false to the theme blueprint - #767
    • Caddyfile and Lighttpd config files updated
    • Removed node_modules folder from backups to make them faster
    • Display error when bin/grav install hasn't been run instead of throwing exception. Prevents "white page" errors if error display is off
    • Improved command line flow when installing multiple packages: don't reinstall packages if already installed, ask once if should use symlinks if symlinks are found
    • Added more tests to our testing suite
    • Added x-ua-compatible to http_equiv metadata processing
    • Added ability to have a per-page frontmatter.yaml file to set header frontmatter defaults. Especially useful for multilang scenarios - #775
    • Removed deprecated bin/grav newuser CLI command. use bin/plugin login newuser instead.
    • Added webm and ogv video types to the default media types list.
    • Fix Zend Opcache opcache.validate_timestamps=0 not detecting changes in compiled yaml and twig files
    • Avoid losing params, query and fragment from the URL when auto-redirecting to a language-specific route - #759
    • Fix for non-pipeline assets getting lost when pipeline is cached to filesystem
    • Fix for double encoding resulting from Markdown Extra
    • Fix for a remote link breaking all CSS rewrites for pipeline
    • Fix an issue with Retina alternatives not clearing properly between repeat uses
    • Fix for non standard http/s external markdown links - #738
    • Fix for find() calling redirects via dispatch() causing infinite loops - #781



    • Added new Page::contentMeta() mechanism to store content-level meta data alongside content
    • Added Japanese language translation
    • Updated some vendor libraries
    • Hide streams blueprint from Admin plugin
    • Fix translations of languages with --- in YAML files



    • New Unit Testing via Codeception
    • New page-level SSL functionality when using absolute_urls
    • Added reverse_proxy config option for issues with non-standard ports
    • Added proxy_url config option to support GPM behind proxy servers #639
    • New Pages::parentsRawRoutes() method
    • Enhanced bin/gpm info CLI command with Changelog support #559
    • Ability to add empty Folder via admin plugin
    • Added latest jQuery 2.2.0 library to core
    • Added translations from Crowdin
    • [BC] Metadata now supports only flat arrays. To use open graph metas and the likes (ie, 'og:title'), simply specify it in the key.
    • Refactored Uri::convertUrl() method to be more reliable + tests created
    • Date for last update of a modular sub-page sets modified date of modular page itself
    • Split configuration up into two steps
    • Moved Grav-based base_uri variables into Uri::init()
    • Refactored init in URI to better support testing
    • Allow twig_vars to be exposed earlier and merged later
    • Avoid setting empty metadata
    • Accept single group access as a string rather than requiring an array
    • Return $this in Page constructor and init to allow chaining
    • Added ext-* PHP requirements to composer.json
    • Use Whoops 2.0 library while supporting old style
    • Removed redundant old default-hash fallback mechanisms
    • Commented out default redirects and routes in site.yaml
    • Added /tests folder to deny's of all webserver-configs/* files
    • Various PS and code style fixes
    • Fix default generator metadata
    • Fix for broken image processing caused by Uri::convertUrl() bugs
    • Fix loading JS and CSS from collections #623
    • Fix stream overriding
    • Remove the URL extension for home link
    • Fix permissions when the user has no access level set at all
    • Fix issue with user with multiple groups getting denied on first group
    • Fixed an issue with Pages() internal cache lookup not being unique enough
    • Fix for bug with site.redirects and site.routes being an empty list
    • [Markdown] Don't process links for special protocols
    • [Whoops] serve JSON errors when request is JSON



    • Added rotate, flip and fixOrientation image medium methods
    • Removed IP from Nonce generation. Should be more reliable in a variety of scenarios



    • Added composer create-project as an additional installation method #585
    • New optional system config setting to strip home from page routs and urls #561
    • Added Greek, Finnish, Norwegian, Polish, Portuguese, and Romanian languages
    • Added new Page->topParent() method to return top most parent of a page
    • Added plugins configuration tab to debugger
    • Added support for APCu and PHP7.0 via new Doctrine Cache release
    • Added global setting for twig_first processing (false by default)
    • New configuration options for Session settings #553
    • Switched to SSL for GPM calls
    • Use URI->host() for session domain
    • Add support for open_basedir when installing packages via GPM
    • Improved Utils::generateNonceString() method to handle reverse proxies
    • Optimized core thumbnails saving 38% in file size
    • Added new bin/gpm index --installed-only option
    • Improved GPM errors to provider more helpful diagnostic of issues
    • Removed old hardcoded PHP version references
    • Moved onPageContentProcessed() event so it's fired more reliably
    • Maintain md5 keys during sorting of Assets #566
    • Update to Caddyfile for Caddy web server
    • Fixed an issue with cache/config checksum not being set on cache load
    • Fix for page blueprint and theme inheritance issue #534
    • Set ZipBackup timeout to 10 minutes if possible
    • Fix case where we only have inline data for CSS or JS #565
    • Fix bin/grav sandbox command to work with new webserver-config folder
    • Fix for markdown attributes on external URLs
    • Fixed issue where data: page header was acting as publish_date:
    • Fix for special characters in URL parameters (e.g. /tag:c++) #541
    • Safety check for an array of nonces to only use the first one



    • Set minimum requirements to PHP 5.5.9
    • Added saveConfig to Themes
    • Updated Whoops to new 2.0 version (PHP 7.0 compatible)
    • Moved sample web server configs into dedicated directory
    • FastCGI will use Apache's mod_deflate if gzip turned off
    • Fix broken media image operators
    • Only call extra method of blueprints if blueprints exist
    • Fix lang prefix in url twig variables #523
    • Fix case insensitive HTTPS check #535
    • Field field validation handles case multiple missing



    • Add ability to extend markdown with plugins
    • Added support for plugins to have individual language files
    • Added 7z to media formats
    • Use Grav's fork of Parsedown until PR is merged
    • New function to persist plugin configuration to disk
    • GPM selfupgrade will now check PHP version requirements
    • If the field allows multiple files, return array
    • Handle non-array values in file validation
    • Fix when looping fields param in a list field
    • Properly convert commas to spaces for media attributes
    • Forcing Travis VM to HI timezone to address future files in zip file



    • Needed to put default image folder permissions for YAML compatibility



    • Fixed issue when saving config causing incorrect image cache folder perms



    • Fix for timing display in debugbar



    • Reduced package sizes by removing extra vendor dev bits
    • Fix issue when you enable debugger from admin plugin



    • Add new link attributes via markdown media
    • Added setters to set state of CSS/JS pipelining
    • Added user/accounts to .gitignore
    • Added configurable permissions option for Image cache
    • Hungarian translation updated
    • Refactored Theme initialization for improved flexibility
    • Wrapped security section of account blueprints in an 'super user' authorize check
    • Minor performance optimizations
    • Updated core page blueprints with markdown preview option
    • Added useful cache info output to Debugbar
    • Added iconv polyfill library used by Symfony 2.8
    • Force lowercase of username in a few places for case sensitive filesystems
    • Fix for GPM problems "Call to a member function set() on null"
    • Fix for individual asset pipeline values not functioning
    • Fix Page::copy() and Page::move() to support multiple moves at once
    • Fixed page moving of a page with no content
    • Fix for wrong ordering when moving many pages
    • Escape root path in page medium files to work with special characters
    • Add missing parent constructor to Themes class
    • Fix missing file error in bin/grav sandbox command
    • Fixed changelog differ when upgrading Grav
    • Fixed a logic error in Validation->validate()
    • Make $container available in setup.php to fix multi-site



    • Refactor Config classes for improved performance!
    • Refactor Data classes to use NestedArrayAccess instead of DataMutatorTrait
    • Added support for classes and id on medium objects to set CSS values
    • Data objects: Allow function call chaining
    • Data objects: Lazy load blueprints only if needed
    • Automatically create unique security salt for each configuration
    • Added Hungarian translation
    • Added support for User groups
    • Improved robots.txt to disallow crawling of non-user folders
    • Nonces only generated once per action and process
    • Added IP into Nonce string calculation
    • Nonces now use random string with random salt to improve performance
    • Improved list form handling #475
    • Vendor library updates
    • Fixed help output for bin/plugin
    • Fix for nested logic for lists and form parsing #273
    • Fix for array form fields and last entry not getting deleted
    • Should not be able to set parent to self #308



    • Added nonce functionality for all admin forms for improved security
    • Implemented the ability for Plugins to provide their own CLI commands through bin/plugin
    • Added Croatian translation
    • Added missing umask_fix property to system.yaml
    • Added current theme's config to global config. E.g. config.theme.dropdown_enabled
    • Added append_url_extension option to system config & page headers
    • Users have a new state property to allow disabling/banning
    • Added new Page.relativePagePath() helper method
    • Added new |pad Twig filter for strings (uses str_pad())
    • Added lighttpd.conf for Lightly web server
    • Clear previously applied operations when doing a reset on image media
    • Password no longer required when editing user
    • Improved support for trailing / URLs
    • Improved .nginx.conf configuration file
    • Improved .htaccess security
    • Updated vendor libs
    • Updated composer.phar
    • Use streams instead of paths for clearCache()
    • Use PCRE_UTF8 so unicode strings can be regexed in Truncator
    • Handle case when login plugin is disabled
    • Improved quality functionality in media handling
    • Added some missing translation strings
    • Deprecated bin/grav newuser in favor of bin/plugin login new-user
    • Moved fallback types to use any valid media type
    • Renamed system.pages.fallback_types to
    • Removed version number in default generator meta tag
    • Disable time limit in case of slow downloads
    • Removed default hash in system.yaml
    • Fix for media using absolute URLs causing broken links
    • Fix theme auto-loading #432
    • Don't create empty <style> or <script> scripts if no data
    • Code cleanups
    • Fix undefined variable in Config class
    • Fix exception message when label is not set
    • Check in Plugins::get() to ensure plugins exists
    • Fixed GZip compression making output buffering work correctly with all servers and browsers
    • Fixed date representation in system config



    • Fixed a fatal error if you have a collection with missing or invalid @page: /route



    • New Page collection options! @self.parent, @self.siblings, @self.descendants + more
    • White list of file types for fallback route functionality (images by default)
    • Assets switched from defines to streams
    • typos fixed
    • Fixed issue with routes that have lang string in them (/en/english)
    • Trim strings before validation so whitespace is not satisfy 'required'



    • Added support for CSS Asset groups
    • Added a wrapped_site system option for themes/plugins to use
    • Pass Page object as event to onTwigPageVariables() event hook
    • New Data.items() method to get all items
    • Missing pipelined remote asset will now fail quietly
    • More reliably handle inline JS and CSS to remove only surrounding HTML tags
    • Medium.meta returns new Data object so null checks are possible
    • Improved Medium metadata merging to allow for automatic title/alt/class attributes
    • Moved Grav object to global variable rather than template variable (useful for macros)
    • German language improvements
    • Updated bundled composer
    • Accept variety of true values in User.authorize() method
    • Fix for Validation throwing an error if no label set



    • Use native PECL YAML parser if installed for 4X speed boost in parsing YAML files
    • Support for inherited theme class
    • Added new default language prepend system configuration option
    • New |evaluate Twig filter to evaluate a string as twig
    • New system option to ignore all hidden files and folders
    • New system option for default redirect code
    • Added ability to append specific [30x] codes to redirect URLs
    • Added url_taxonomy_filters for page collections
    • Added @root page and recurse flag for page collections
    • Support for multiple page collection types as an array
    • Added Dutch language file
    • Added Russian language file
    • Added remove method to User object
    • Moved hardcoded mimetypes to media.yaml to be treated as Page media files
    • Set errors: display: false by default in system.yaml
    • Strip out extra slashes in the URI
    • Validate hostname to ensure it is valid
    • Ignore more SCM folders in Backups
    • Removed home_redirect settings from system.yaml
    • Added Page media as root twig object for consistency
    • Updated to latest vendor libraries
    • Optimizations to Asset pipeline logic for minor speed increase
    • Block direct access to a variety of files in .htaccess for increased security
    • Debugbar vendor library update
    • Always fallback to english if other translations are not available
    • Fix for redirecting external URL with multi-language
    • Fix for Asset pipeline not respecting asset groups
    • Fix language files with child/parent theme relationships
    • Fixed a regression issue resulting in incorrect default language
    • Ensure error handler is initialized before URI is processed
    • Use default language in Twig if active language is not set
    • Fixed issue with safeEmailFilter() Twig filter not separating with ; properly
    • Fixed empty YAML file causing error with native PECL YAML parser
    • Fixed SVG mimetype
    • Fixed incorrect Cache-control: max-age value format



    • Fixed a regression issue resulting in incorrect default language



    • Added Redis back as a supported cache mechanism
    • Allow Twig nicetime translations
    • Added -y option for 'Yes to all' in bin/gpm update
    • Added CSS media attribute to the Assets manager
    • New German language support
    • New Czech language support
    • New French language support
    • Added modulus twig filter
    • URL decode in medium actions to allow complex syntax
    • Take into account HTTP_HOST before SERVER_NAME (helpful with Nginx)
    • More friendly cache naming to ease manual management of cache systems
    • Added default Apache resource for DirectoryIndex
    • Fix GPM failure when offline
    • Fix open_basedir error in bin/gpm install
    • Fix an HHVM error in Truncator
    • Fix for XSS vulnerability with params
    • Fix chaining for responsive size derivatives
    • Fix for saving pages when removing the page title and all other header elements
    • Fix when saving array fields
    • Fix for ports being included in HTTP_HOST
    • Fix for Truncator to handle PHP tags gracefully
    • Fix for locate style lang codes in getNativeName()
    • Urldecode image basenames in markdown



    • Added new AudioMedium for HTML5 audio
    • Added ability for Assets to be added and displayed in separate groups
    • New support for responsive image derivative sizes
    • GPM theme install now uses a copy method so new files are not lost (e.g. /css/custom.css)
    • Code analysis improvements and cleanup
    • Removed Twig panel from debugger (no longer supported in Twig 1.20)
    • Updated composer packages
    • Prepend active language to convertUrl() when used in markdown links
    • Added some pre/post flight options for installer via blueprints
    • Hyphenize the site name in the backup filename
    • Fix broken routable logic
    • Check for phpinfo() method in case it is restricted by hosting provider
    • Fixes for windows when running GPM
    • Fix for ampersand (&) causing error in truncateHtml() via Page.summary()



    • Fixed User.authorise() to be backwards compabile



    • New and improved multibyte-safe TruncateHTML function and filter
    • Added support for custom page date format
    • Added a string Twig filter to render as json_encoded string
    • Added authorize Twig filter
    • Added support for theme inheritance in the admin
    • Support for multiple content collections on a page
    • Added configurable files/folders ignores for pages
    • Added the ability to set the default PHP locale and override via multi-lang configuration
    • Added ability to save as YAML via admin
    • Added check for mbstring support
    • Added new redirect header for pages
    • Changed dependencies from develop to master
    • Updated logging to log everything from debug level on (was warning)
    • Added missing accounts/ folder
    • Default to performing a 301 redirect for URIs with trailing slashes
    • Improved Twig error messages
    • Allow validating of forms from anywhere such as plugins
    • Added logic so modular pages are by default non-routable
    • Hide password input in bin/grav newuser command
    • Fixed Pages.all() not returning modular pages
    • Fix for modular template types not getting found
    • Fix for markdown_extra: overriding markdown:extra: setting
    • Fix for multi-site routing
    • Fix for multi-lang page name error
    • Fixed a redirect loop in URI class
    • Fixed a potential error when unsupported_inline_types is empty
    • Correctly generate 2x retina image
    • Typo fixes in page publish/unpublish blueprint



    • Added some new Twig filters: defined, rtrim, ltrim
    • Admin support for customizable page file name + template override
    • Better message for incompatible/unsupported Twig template
    • Improved User blueprints with better help
    • Switched to composer install rather than update by default
    • Admin autofocus on page title
    • .htaccess hardening (.htaccess & htaccess.txt)
    • Cache safety checks for missing folders
    • Fixed issue with unescaped o character in date formats



    • not triggering on homepage
    • Fix for invalid session name in Opera browser



    • Added language to user blueprint
    • Added translations to blueprints
    • New extending logic for blueprints
    • Blueprints are now loaded with Streams to allow for better overrides
    • Added new Symfony dump() method
    • Catch YAML header parse exception so site doesn't die
    • Better Page.parent() logic
    • Improved GPM display layout
    • Tweaked default page layout
    • Unset route and slug for improved reliability of route changes
    • Added requirements to
    • Updated various libraries
    • Allow use of custom page date field for dateRange collections
    • Slug fixes with GPM
    • Unset plaintext password on save
    • Fix for trailing / not matching active children



    • Fixed issue when saving header.process in page forms via the admin plugin
    • Fixed error due to use of set_time_limit that might be disabled on some hosts



    • Added a new newuser CLI command to create user accounts
    • Added default blueprint for all templates
    • Support user and system language translation merging
    • Added isSymlink method in GPM to determine if Grav is symbolically linked or not
    • Refactored page recursing
    • Updated blueprints to use new toggles
    • Updated blueprints to use current date for date format fields
    • Updated composer.phar
    • Use sessions for admin even when disabled for site
    • Use GRAV_ROOT in session identifier



    • Added body_classes field
    • Added visiblity toggle and help tooltips on new page form
    • Added new Page.unsetRoute() method to allow admin to regenerate the route
    • User save no longer stores username each time
    • Page list form field now shows all pages except root
    • Removed required option from page title
    • Added configuration settings for running Nginx in sub directory
    • Fixed deep translation merging
    • Fixed broken metadata merging with site defaults
    • Fixed broken summary field
    • Fixed broken robots field
    • Fixed GPM issue when using cURL, throwing an Undefined offset: 1 exception
    • Removed duplicate hidden page type field



    • Added new cache_all system setting + media cache() method
    • Added base languages configuration
    • Added property language to page to help plugins identify page language
    • New Utils::arrayFilterRecursive() method
    • Improved Session handling to support site and admin independently
    • Allow Twig variables to be modified in other events
    • Blueprint updates in preparation for Admin plugin
    • Changed Inflector from static to object and added multi-language support
    • Support for admin override of a page's blueprints
    • Removed unused use in VideoMedium that was causing error
    • Array fix in User.authorise() method
    • Fix for typo in translations_fallback
    • Fixed moving page to the root



    • Added new onImageMediumSaved() event (useful for post-image processing)
    • Added Vary: Accept-Encoding option
    • Multilang-safe delimiter position
    • Refactored Twig classes and added optional umask setting
    • Removed pageinit() timing
    • Page->routable() now takes published() state into account
    • Improved how page extension is set
    • Support Language->translate() method taking string and array
    • Fixed backup command to include empty folders



    • Detect users preferred language via http_accept_language setting
    • Added new translateArray() language method
    • Support en translations by default for plugins & themes
    • Improved default generator tag
    • Minor language tweaks and fixes
    • Fix for session active language and homepage redirects
    • Ignore root-level page rather than throwing error



    • Added xml, json, css and js to valid media file types
    • Better handling of unsupported media type downloads
    • Improved bin/grav backup command to mimic admin plugin location/name
    • Critical fix for broken language translations
    • Fix for Twig markdown filter error
    • Safety check for download extension



    • BIG NEWS! Extensive Multi-Language support is all new in 0.9.30!
    • Translation support via Twig filter/function and PHP method
    • Page specific default route
    • Page specific route aliases
    • Canonical URL route support
    • Added built-in session support
    • New Page.rawRoute() to get a consistent folder-based route to a page
    • Added option to always redirect to default page on alias URL
    • Added language safe redirect function for use in core and plugins
    • Improved and Page.activeChild() methods to support route aliases
    • Various spelling corrections in .php comments, .md and .yaml files
    • Utils::startsWith() and Utils::endsWith() now support needle arrays
    • Added a new timer around pageInitialized event
    • Updated jQuery library to v2.1.4
    • In-page CSS and JS files are now handled properly
    • Fix for enable_media_timestamp not working properly



    • New and improved Regex-powered redirect and route alias logic
    • Added new onBuildPagesInitialized event for memory critical or time-consuming plugins
    • Added a setSummary() method for pages
    • Improved MergeConfig() logic for more control
    • Travis skeleton build trigger implemented
    • Set composer.json versions to stable versions where possible
    • Disabled last_modified and etag page headers by default (causing too much page caching)
    • Preload classes during bin/gpm selfupgrade to avoid issues with updated classes
    • Fix for directory relative down links



    • Added method to set raw markdown on a page
    • Added ability to enabled system and page level etag and last_modified headers
    • Improved image path processing
    • Improved query string handling
    • Optimization to image handling supporting URL encoded filenames
    • Use global composer when available rather than Grv provided one
    • Use PHP_BINARY constant rather than php executable
    • Updated Doctrine Cache library
    • Updated Symfony libraries
    • Moved convertUrl() method to Uri object
    • Fix incorrect slug causing problems with CLI uninstall
    • Fix Twig runtime error with assets pipeline in sufolder installations
    • Fix for + in image filenames
    • Fix for dot files causing issues with page processing
    • Fix for Uri path detection on Windows platform
    • Fix for alternative media resolutions
    • Fix for modularTypes key properties



    • Added new composer CLI command
    • Added page-level summary header overrides
    • Added size back for Media objects
    • Refactored Backup command in preparation for admin plugin
    • Added a new parseLinks method to Plugins class
    • Added starts_with and ends_with Twig filters
    • Optimized install of vendor libraries for speed improvement
    • Improved configuration handling in preparation for admin plugin
    • Cache optimization: Don't cache Twig templates when you pass dynamic params
    • Moved Utils::rcopy to Folder::rcopy
    • Improved Folder::doDelete
    • Added check for required Curl in GPM
    • Updated included composer.phar to latest version
    • Various blueprint fixes for admin plugin
    • Various PSR and code cleanup tasks
    • Fix issue with Gzip not working with onShutDown() event
    • Fix for URLs with trailing slashes
    • Handle condition where certain errors resulted in blank page
    • Fix for issue with theme name equal to base_url and asset pipeline
    • Fix to properly normalize font rewrite path
    • Fix for absolute URLs below the current page
    • Fix for .. page references



    • Fixed issue with homepage routes failing with 'dirname' error



    • Added support for E-Tag, Last-Modified, Cache-Control and Page-based expires headers
    • Refactored media image handling to make it more flexible and support absolute paths
    • Refactored page modification check process to make it faster
    • User account improvements in preparation for admin plugin
    • Protect against timing attacks
    • Reset default system expires time to 0 seconds (can override if you need to)
    • Fix issues with spaces in webroot when using bin/grav install
    • Fix for spaces in relative directory
    • Bug fix in collection filtering



    • Added support for chunked downloads of Assets
    • Added new onBeforeDownload() event
    • Added new download() and getMimeType() methods to Utils class
    • Added configuration option for supported page types
    • Added assets and media timestamp options (off by default)
    • Added page expires configuration option
    • Fixed issue with Nginx/Gzip and ob_flush() throwing error
    • Fixed assets actions on 'direct media' URLs
    • Fix for 'direct assets` with any parameters



    • Fix for broken GPM selfupgrade (Grav 0.9.21 and 0.9.22 will need to manually upgrade to this version)



    • Fix to normalize GRAV_ROOT path for Windows
    • Fix to normalize Media image paths for Windows
    • Fix for GPM selfupgrade when you are on latest version



    • Major Media functionality enhancements: SVG, Animated GIF, Video support!
    • Added ability to configure default image quality in system configuration
    • Added sizes attributes for custom retina image breakpoints
    • Don't scale @1x retina images
    • Add filter to Iterator class
    • Updated various composer packages
    • Various PSR fixes



    • Added addAsyncJs() and addDeferJs() to Assets manager
    • Added support for extranal URL redirects
    • Fix unpredictable asset ordering when set from plugin/system
    • Updated nginx.conf to ensure system assets are accessible
    • Ensure images are served as static files in Nginx
    • Updated vendor libraries to latest versions
    • Updated included composer.phar to latest version
    • Fixed issue with markdown links to # breaking HTML



    • Added named assets capability and bundled jQuery into Grav core
    • Added first() and last() to Iterator class
    • Improved page modification routine to skip dot files
    • Only use files to calculate page modification dates
    • Broke out Folder iterators into their own classes
    • Various Sensiolabs Insight fixes
    • Fixed Iterator.nth() method



    • Added ability for GPM install to automatically install _demo content if found (w/backup)
    • Added ability for themes and plugins to have dependencies required to install via GPM
    • Added ability to override the system timezone rather than relying on server setting only
    • Added new Twig filter random_string for generating random id values
    • Added new Twig filter markdown for on-the-fly markdown processing
    • Added new Twig filter absoluteUrl to convert relative to absolute URLs
    • Added new processTemplate() method to Twig object for on-the-fly processing of twig template
    • Added rcopy() and contains() helper methods in Utils
    • Provided new param_sep variable to better support Apache on Windows
    • Moved parsedown configuration into the trait
    • Added optional deep-copy option to mergeConfig() for plugins
    • Updated bundled composer.phar package
    • Various Sensiolabs Insight fixes - Silver level now!
    • Various PSR Fixes
    • Fix for windows platforms not displaying installed themes/plugins via GPM
    • Fix page IDs not picking up folder-only pages



    • Added full HHVM support! Get your speed on with Facebook's crazy fast PHP JIT compiler
    • More flexible page summary control
    • Support CamelCase plugin and theme class names. Replaces dashes and underscores
    • Moved summary delimiter into site.yaml so it can be configurable
    • Various PSR fixes
    • Fix for mergeConfig() not falling back to defaults
    • Fix for addInlineCss() and addInlineJs() Assets not working between Twig tags
    • Fix for Markdown adding HTML tags into inline CSS and JS



    • Added Retina and Responsive image support via Grav media and srcset image attribute
    • Added image debug option that overlays responsive resolution
    • Added a new image cache stream
    • Improved the markdown Lightbox functionality to better mimic Twig version
    • Fullsize Lightbox can now have filters applied
    • Added a new mergeConfig() method to Plugin class to merge system + page header configuration
    • Added a new disable() method to Plugin class to programmatically disable a plugin
    • Updated Parsedown and Parsedown Extra to address bugs
    • Various PSR fixes
    • Fix bug with image dispatch in traditionally non-routable pages
    • Fix for markdown link not working on non-current pages
    • Fix for markdown images not being found on homepage



    • Typo in video mime types
    • Fix for old markdown_extra system setting not getting picked up
    • Fix in regex for Markdown links with numeric values in path
    • Fix for broken image routing mechanism that got broken at some point
    • Fix for markdown images/links in pages with page slug override



    • Added GZip support
    • Added multiple configurations via setup.php
    • Added base structure for unit tests
    • New onPageContentRaw() plugin event that processes before any page processing
    • Added ability to dynamically set Metadata on page
    • Added ability to dynamically configure Markdown processing via Parsedown options
    • Refactored page.content() method to be more flexible and reliable
    • Various updates and fixes for streams resulting in better multi-site support
    • Updated Twig, Parsedown, ParsedownExtra, DoctrineCache libraries
    • Refactored Parsedown trait
    • Force modular pages to be non-visible in menus
    • Moved RewriteBase before Exploits in .htaccess
    • Added standard video formats to Media support
    • Added priority for inline assets
    • Check for uniqueness when adding multiple inline assets
    • Improved support for Twig-based URLs inside Markdown links and images
    • Improved Twig url() function
    • Fix for HTML entities quotes in Metadata values
    • Fix for published setting to have precedent of publish_date and unpublish_date
    • Fix for onShutdown() events not closing connections properly in php-fpm environments



    • Added new published true|false state in page headers
    • Added publish_date in page headers to automatically publish page
    • Added unpublish_date in page headers to automatically unpublish page
    • Added dateRange() capability for collections
    • Added ability to dynamically control Cache lifetime programmatically
    • Added ability to sort by anything in the page header. E.g. sort: header.taxonomy.year
    • Added various helper methods to collections: copy, nonVisible, modular, nonModular, published, nonPublished, nonRoutable
    • Modified all Collection methods so they can be chained together: $collection->published()->visible()
    • Set default Cache lifetime to default of 1 week (604800 seconds) - was infinite
    • House-cleaning of some unused methods in Pages object
    • Fix uninstall GPM command that was broken in last release
    • Fix for intermittent undefined index error when working with Collections
    • Fix for date of some pages being set to incorrect future timestamps



    • Added an all-access robots.txt file for search engines
    • Added new GPM uninstall command
    • Added support for in-page Twig processing in modular pages
    • Added configurable support for undefined Twig functions and filters
    • Fall back to default .html template if error occurs on non-html pages
    • Added ability to have PSR-1 friendly plugin names (CamelCase, no-dashes)
    • Fix to composer.json to deter API rate-limit errors
    • Added non-exception-throwing handler for undefined methods on Medium objects
    • Fix description for self-upgrade method of GPM command
    • Fix for incorrect version number when performing GPM update
    • Fix for argument description of GPM install command
    • Fix for recalcitrant CodeKit mac application



    • Added support for simple redirects as well as routes
    • Handle Twig errors more cleanly
    • Fix for error caused by invalid or missing user agent string
    • Fix for directory relative links and URL fragments (#pagelink)
    • Fix for relative links with no subfolder in base_url



    • Added Facebook-style nicetime date Twig filter
    • Moved clear-cache functionality into Cache object required for Admin plugin
    • Fix for undefined index with previous/next buttons



    • Added new @page collection type
    • Added ksort and contains Twig filters
    • Added gist Twig function
    • Refactored Page previous/next/adjacent functionality
    • Updated to Symfony 2.6 for yaml/console/event-dispatcher libraries
    • More PSR code fixes
    • Fix for over-escaped apostrophes in YAML



    • Added configuration option to set default lifetime on cache saves
    • Added ability to set HTTP status code from page header
    • Implemented simple wild-card custom routing
    • Fixed elusive double load to fully cache issue (crossing fingers...)
    • Ensure Twig tags are treated as block items in markdown
    • Removed some older deprecated methods
    • Ensure onPageContentProcessed() event only fires when not cached
    • More PSR code fixes
    • Fix issue with miscalculation of blog separator location ===



    • Nginx configuration updated
    • Added badge to README
    • Removed set_time_limit() and put checks around ignore_user_abort
    • More PSR code fixes
    • Fix issue with non-valid asset path showing up when they shouldn't
    • Fix for JS asset pipeline and scripts that don't end in ;
    • Fix for schema-based markdown URLs broken routes (eg mailto:)



    • Moved base_url variables into Grav container
    • Forced media sorting to use natural sort order by default
    • Various PSR code tidying
    • Added filename, extension, thumb to all medium objects
    • Fix for infinite loop in page.content()
    • Fix hostname for configuration overrides
    • Fix for cached configuration
    • Fix for relative URLs in markdown on installs with no base_url
    • Fix for page media images with uppercase extension



    • Added quality setting to medium for compression configuration of images
    • Added new onPageContentProcessed() event that is post-content processing but pre-caching
    • Added support for AND and OR taxonomy filtering. AND by default (was OR)
    • Added specific clearing options for CLI clear-cache command
    • Moved environment method to URI so it can be accessible in plugins and themes
    • Set Grav's output variable to public so it can be manipulated in onOutputGenerated event
    • Updated vendor libraries to latest versions
    • Better handing of 'home' in active menu state detection
    • Various PSR code tidying
    • Improved some error messages and notices
    • Force route rebuild when configuration changes
    • Fix for 'installed undefined' error in CLI versions command
    • Do not remove the JSON/Text error handlers
    • Fix for supporting inline JS and CSS when Asset pipeline enabled
    • Fix for Data URLs in CSS being badly formed
    • Fix Markdown links with fragment and query elements



    • New improved Debugbar with messages, timing, config, twig information
    • New exception handling system utilizing Whoops
    • New logging system utilizing Monolog
    • Support for auto-detecting environment configuration
    • New version command for CLI
    • Integrate Twig dump() calls into Debugbar
    • Selfupgrade now clears cache on successful upgrade
    • Selfupgrade now supports files without extensions
    • Improved error messages when plugin is missing
    • Improved security in .htaccess
    • Support CSS/JS/Image assets in vendor/system folders via .htaccess
    • Add support for system timers
    • Improved and optimized configuration loading
    • Automatically disable Debugbar on non-HTML pages
    • Disable Debugbar by default
    • More YAML blueprint fixes
    • Fix potential double // in assets
    • Load debugger as early as possible



    • GPM (Grav Package Manager) Added
    • Support for multiple Grav configurations
    • Dynamic media support via URL
    • Added inlineCss and inlineJs support for Assets
    • YAML caching for increased performance
    • Use stream wrapper in pages, plugins and themes
    • Switched to RocketTheme toolbox for some core functionality
    • Renamed setup CLI command to sandbox
    • Broke cache types out into multiple directories in the cache folder
    • Removed vendor libs from github repository
    • Various PSR cleanup of code
    • Various Blueprint updates to support upcoming admin plugin
    • Added ability to filter page children for normal/modular/all
    • Added sort_by_key twig filter
    • Added visible() and routable() filters to page collections
    • Use session class in shutdown process
    • Improvements to modular page loading
    • Various code cleanup and optimizations
    • Fixed file checking not updating the last modified time. For real this time!
    • Switched debugger to PRODUCTION mode by default
    • Various fixes in URI class for increased reliability



    • New flexible site and page metadata support including ObjectGraph and Facebook
    • New method to get user IP address in URI object
    • Added new onShutdown() event that fires after connection is closed for Async features
    • Skip assets pipeline minify on Windows platforms by default due to PHP issue 47689
    • Fixed multiple level menus not highlighting correctly
    • Updated some blueprints in preparation for admin plugin
    • Fail gracefully when theme does not exist
    • Add stream support into ResourceLocator::addPath()
    • Separate themes from plugins, add themes:// stream and onTask events
    • Added barDump() to Debugger
    • Removed stray test page
    • Override modified only if a non-markdown file was modified
    • Added assets attributes support
    • Auto-run composer install when running the Grav CLI
    • Vendor folder removed from repository
    • Minor configuration performance optimizations
    • Minor debugger performance optimizations
    • Fix url() twig function when Grav isn't installed at root
    • Workaround for PHP bug 52065
    • Fixed getList() method on Pages object that was not working
    • Fix for open_basedir error
    • index.php now warns if not running on PHP 5.4
    • Removed memcached option (redundant)
    • Removed memcache from auto setup, added memcache server configuration option
    • Fix broken password validation
    • Back to proper PSR-4 Autoloader



    • Added new theme:// PHP stream for current theme
    • Default to new file modification checking rather than folder
    • Added support for various markdown link formats to convert to Grav-friendly URLs
    • Moved configure() from Theme to Themes class
    • Fix autoloading without composer update -o
    • Added support for Twig url method
    • Minor code cleanup
    • Fixed issue with page changes not being picked up
    • Fixed Minify to provide @supports tag compatibility
    • Fixed ResourceLocator not working with multiple paths
    • Fixed issue with Markdown process not stripping LFs
    • Restrict file type extensions for added security
    • Fixed template inheritance
    • Moved Browser class to proper location



    • Addition of Dependency Injection Container
    • Refactored plugins to use Symfony Event Dispatcher
    • New Asset Manager to provide unified management of JavaScript and CSS
    • Asset Pipelining to provide unification, minify, and optimization of JavaScript and CSS
    • Grav Media support directly in Markdown syntax
    • Additional Grav Generator meta tag in default themes
    • Added support for PHP Stream Wrapper for resource location
    • Markdown Extra support
    • Browser object for fast browser detection
    • PSR-4 Autoloader mechanism
    • Tracy Debugger new detect option to detect running environment
    • Added new random collection sort option
    • Make media images progressive by default
    • Additional URI filtering for improved security
    • Safety checks to ensure PHP 5.4.0+
    • Move to Slidebars side navigation in default Antimatter theme
    • Updates to .htaccess including section on RewriteBase which is needed for some hosting providers
    • Fixed issue when installing in an apache userdir (~username) folder
    • Various mobile CSS issues in default themes
    • Various minor bug fixes



    • Initial Release