Update docs, release version 3.0.0

Author: nilshoerrmann

.editorconfig

@@ -1,20 +1,14 @@
-# This file is for unifying the coding style for different editors and IDEs
-# editorconfig.org
-
 [*]
-charset = utf-8
-indent_style = space
-indent_size = 2
 end_of_line = lf
-insert_final_newline = true
+charset = utf-8
 trim_trailing_whitespace = true
-
-[*.php]
+insert_final_newline = true
+indent_style = space
 indent_size = 4
+max_line_length = 80
 
-[*.md,*.txt]
-trim_trailing_whitespace = false
-insert_final_newline = false
+[*.yml]
+indent_size = 2
 
-[composer.json]
-indent_size = 4
+[*.md]
+trim_trailing_whitespace = false

.gitattributes

@@ -1,10 +1,21 @@
 {
+    "bracketSameLine": false,
+    "bracketSpacing": true,
+    "htmlWhitespaceSensitivity": "css",
+    "phpVersion": "8.2",
     "printWidth": 80,
+    "proseWrap": "never",
     "semi": true,
     "singleQuote": true,
     "trailingComma": "none",
-    "bracketSpacing": true,
-    "jsxBracketSameLine": true,
-    "phpVersion": "7.3",
-    "trailingCommaPHP": false
+    "trailingCommaPHP": false,
+    "plugins": ["@prettier/plugin-php", "prettier-plugin-css-order"],
+    "overrides": [
+        {
+            "files": "LICENSE.md",
+            "options": {
+                "proseWrap": "always"
+            }
+        }
+    ]
 }

.prettierrc

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2020 hana+nils · Büro für Gestaltung
+Copyright (c) hana+nils · Büro für Gestaltung
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

LICENSE.md

@@ -1,6 +1,6 @@
 ![Kirby Date Methods](.github/title.png)
 
-Date Methods is a plugin for [Kirby 3](https://getkirby.com) that allows for advanced date and time parsing and formatting using PHP's core date objects. It offers methods for fields to handle single dates, methods for pages to handle multiple dates (ranges) and also provides helper functions to simplify working with dates and times in general.
+Date Methods is a plugin for [Kirby](https://getkirby.com) that allows for advanced date and time parsing and formatting using PHP's core date objects. It offers methods for fields to handle single dates, methods for pages to handle multiple dates (ranges) and also provides helper functions to simplify working with dates and times in general.
 
 ## Overview
 
@@ -22,17 +22,13 @@ Converters read a date string and convert it to PHP date and time objects like `
 $datetime = $page->date()->toDateTime();
 
 // Modify and format date
-$page
-  ->date()
-  ->toDateTime()
-  ->modify('+1 month')
-  ->format('Y-m-d');
+$page->date()->toDateTime()->modify('+1 month')->format('Y-m-d');
 
 // Compare a date field to another date
 $page
-  ->date()
-  ->toDateDiff('2000-01-01')
-  ->format('The beginning of the century was %y ago.');
+    ->date()
+    ->toDateDiff('2000-01-01')
+    ->format('The beginning of the century was %y ago.');
 ```
 
 ### 2. Formatters
@@ -89,10 +85,7 @@ $published->toFormatted(IntlDateFormatter::LONG, IntlDateFormatter::SHORT);
 
 // Get a user's birthday this year
 echo 'Bastian’s birthday is on ' .
-  $user
-    ->birthday()
-    ->toCurrentYear()
-    ->toFormatted();
+    $user->birthday()->toCurrentYear()->toFormatted();
 ```
 
 ### 4. Validators
@@ -371,16 +364,14 @@ Converts the given date string to `H:i` format.
 
 There are several options to customize the plugin behaviour:
 
-| option              | description                                                                                                                                                                         | default                   |
-|---------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------|
-| `code`              | The locale                                                                                                                                                                          | `de`                      |
-| `rangeseparator`    | The string used to separate a date range, e.g. `01.08.–05.08.24`                                                                                                                    | `–`                       |
-| `datetimeseparator` | The string used to separate date and time, e.g. `01.08., 10:00`                                                                                                                     | `, `                      |
-| `datetype`          | The date format used. <br/>Must be one of [the predefined constants in IntlDateFormatter](https://www.php.net/manual/en/class.intldateformatter.php#intldateformatter.constants.full) | `IntlDateFormatter::LONG` |
-| `timetype`          | The time format used. <br/>Must be one of [the predefined constants in IntlDateFormatter](https://www.php.net/manual/en/class.intldateformatter.php#intldateformatter.constants.full) | `IntlDateFormatter::SHORT` |
-
+| option | description | default |
+| --- | --- | --- |
+| `code` | The locale | `de` |
+| `rangeseparator` | The string used to separate a date range, e.g. `01.08.–05.08.24` | `–` |
+| `datetimeseparator` | The string used to separate date and time, e.g. `01.08., 10:00` | `, ` |
+| `datetype` | The date format used. <br/>Must be one of [the predefined constants in IntlDateFormatter](https://www.php.net/manual/en/class.intldateformatter.php#intldateformatter.constants.full) | `IntlDateFormatter::LONG` |
+| `timetype` | The time format used. <br/>Must be one of [the predefined constants in IntlDateFormatter](https://www.php.net/manual/en/class.intldateformatter.php#intldateformatter.constants.full) | `IntlDateFormatter::SHORT` |
 
 # License
 
-This plugin is provided freely under the [MIT license](LICENSE.md) by [hana+nils · Büro für Gestaltung](https://hananils.de).
-We create visual designs for digital and analog media.
+This plugin is provided freely under the [MIT license](LICENSE.md) by [hana+nils · Büro für Gestaltung](https://hananils.de). We create visual designs for digital and analog media.

README.md

@@ -1,20 +1,34 @@
 {
     "name": "hananils/kirby-date-methods",
-    "description": "Kirby 3 plugin providing field and page methods for formatting dates and creating PHP date objects.",
-    "type": "kirby-plugin",
+    "description": "Parsing and formatting dates can be difficult, especially if you deal with multilingual content. Date Methods aims to simplify date output by providing page and field methods to handle points in time as well as date ranges accurately in your snippets and templates.",
     "license": "MIT",
-    "version": "2.1.0",
+    "type": "kirby-plugin",
+    "version": "3.0.0",
     "authors": [
         {
             "name": "hana+nils · Büro für Gestaltung",
             "email": "buero@hananils.de"
         }
     ],
+    "homepage": "https://kirby.hananils.de/plugins/date-methods",
     "require": {
-        "getkirby/composer-installer": "^1.1",
+        "php": "^8.2",
         "openpsa/ranger": "^0.5.1"
     },
+    "require-dev": {
+        "ergebnis/composer-normalize": "^2.47",
+        "rector/rector": "^2.0"
+    },
+    "replace": {
+        "symfony/intl": "*"
+    },
+    "suggest": {
+        "symfony/intl": "~2.6|~3.4|~4.0|~5.0|~6.0|~7.0"
+    },
     "config": {
-        "optimize-autoloader": true
+        "allow-plugins": {
+            "ergebnis/composer-normalize": true
+        },
+        "sort-packages": true
     }
 }