diff --git a/DEVTOOLS.md b/DEVTOOLS.md new file mode 100644 index 0000000000..dfc3231b84 --- /dev/null +++ b/DEVTOOLS.md @@ -0,0 +1,42 @@ +# Additional development tools + +Various components used within Textpattern (such as the bundled themes and language translations) are maintained in other repositories. Textpattern has a simple development toolset built on [Node.js](https://nodejs.org/) to pull the distribution files of those repositories into the core as required. + +You can install Node.js using the [installer](https://nodejs.org/en/download/) or [package manager](https://nodejs.org/en/download/package-manager/). + +Install required dev tools: + +```ShellSession +npm install +``` + +Pull the following components from the CLI: + +```ShellSession +npm run get-default-theme +npm run get-classic-admin-theme +npm run get-hive-admin-theme +npm run get-pophelp +npm run get-textpacks +npm run get-dependencies +``` + +To request a specific tag or branch: + +```ShellSession +npm run get-default-theme 4.9.0 +npm run get-classic-admin-theme 4.9.0 +npm run get-classic-admin-theme 4.9.x +npm run get-hive-admin-theme 4.9.x +npm run get-textpacks 4.9.x +``` + +Release tools: + +Usage: `npm run txp-gitdist [dest-dir]` (`dest-dir` defaults to a temporary location). + +```ShellSession +npm run txp-index +npm run txp-checksums ./textpattern +npm run txp-gitdist 1.2.3 ../my-dest-dir +``` diff --git a/README.md b/README.md index 87a25827b0..6e123d4094 100644 --- a/README.md +++ b/README.md @@ -28,14 +28,15 @@ Ensure the server meets or exceeds the [system requirements](https://textpattern ## Download Textpattern -The current production release is version 4.8.8. It can be downloaded from the Textpattern website or GitHub in .zip and .tar.gz varieties. +The current production release is version 4.9.0. It can be downloaded from the Textpattern website or GitHub in .zip, .tar.gz, and .tar.xz varieties. -If you want to use the multi-site functionality in Textpattern, get the .tar.gz archive. +If you want to use the multi-site functionality in Textpattern, get the .tar.gz or .tar.xz archive. | | textpattern.com | GitHub | |--------|:-------:|:-----:| -| .zip | [Download](https://textpattern.com/file_download/118/textpattern-4.8.8.zip) | [Download](https://github.com/textpattern/textpattern/releases/download/4.8.8/textpattern-4.8.8.zip) | -| .tar.gz | [Download](https://textpattern.com/file_download/117/textpattern-4.8.8.tar.gz) | [Download](https://github.com/textpattern/textpattern/releases/download/4.8.8/textpattern-4.8.8.tar.gz) | +| .zip | [Download](https://textpattern.com/file_download/124/textpattern-4.9.0.zip) | [Download](https://github.com/textpattern/textpattern/releases/download/4.9.0/textpattern-4.9.0.zip) | +| .tar.gz | [Download](https://textpattern.com/file_download/125/textpattern-4.9.0.tar.gz) | [Download](https://github.com/textpattern/textpattern/releases/download/4.9.0/textpattern-4.9.0.tar.gz) | +| .tar.xz | [Download](https://textpattern.com/file_download/126/textpattern-4.9.0.tar.xz) | [Download](https://github.com/textpattern/textpattern/releases/download/4.9.0/textpattern-4.9.0.tar.xz) | ## Install Textpattern @@ -44,11 +45,11 @@ Please see [README.txt](https://github.com/textpattern/textpattern/blob/main/REA ## Upgrade Textpattern -Please see [README.txt](https://github.com/textpattern/textpattern/blob/main/README.txt) for details on upgrading Textpattern. +Please see [UPGRADE.txt](https://github.com/textpattern/textpattern/blob/main/UPGRADE.txt) for details on upgrading Textpattern. ## Help and Support -The [Textpattern support forum](https://forum.textpattern.com) is home to a friendly and helpful community of Textpattern users and experts. Textpattern also has a social network presence on [Mastodon](https://textpattern.com/mastodon) and [Twitter](https://textpattern.com/twitter). +The [Textpattern support forum](https://forum.textpattern.com) is home to a friendly and helpful community of Textpattern users and experts. Textpattern also has a social network presence on [Mastodon](https://textpattern.com/mastodon) and [X](https://textpattern.com/x). ## Development @@ -62,20 +63,26 @@ The following table outlines anticipated forthcoming changes to system requireme #### Textpattern development versions -Note that targeted versions listed may change multiple times during the development process. +We are targeting Textpattern 5 as the next major release. Refer to the following table for anticipated changes to system requirements for Textpattern 5. -We are targeting Textpattern 4.9 as the next minor release. Refer to the following table for anticipated changes to system requirements. +We generally recommend running Textpattern on platforms with active vendor support where possible, though we also maintain a minimum system requirements list for situations where that isn't viable. + +Note that versions listed may change multiple times during the development process. | | Minimum | Recommended | |--------|:-------:|:-----:| -| PHP | 5.6 | [vendor supported](https://php.net/supported-versions.php)
(8.1, 8.2 or 8.3) | -| MySQL | 5.5 | [vendor supported LTS](https://www.mysql.com/support/supportedplatforms/database.html)
(8.0) | -| Apache | — | vendor supported
(2.4) | -| Nginx | — | mainline (1.25) or stable (1.24) | +| PHP | — | [vendor supported](https://php.net/supported-versions.php) | +| MySQL | — | [vendor supported LTS](https://www.mysql.com/support/supportedplatforms/database.html) | +| Apache | — | vendor supported | +| Nginx | — | mainline or stable | ## Contributing -Do you want to help with the development of Textpattern? Please refer to the [contributing documentation](https://github.com/textpattern/textpattern/blob/dev/CONTRIBUTING.md) for full details. +Please refer to the [contributing documentation](https://github.com/textpattern/textpattern/blob/dev/CONTRIBUTING.md) for more details of Textpattern development. + +## Additional development tools + +Please refer to the [additional devevelopment tools](https://github.com/textpattern/textpattern/blob/dev/DEVTOOLS.md) document. ## GitHub topic tags @@ -87,50 +94,6 @@ If you use GitHub for Textpattern-related development please consider adding som * [`textpattern-website`](https://github.com/topics/textpattern-website) (for websites built with Textpattern) * [`textpattern-development`](https://github.com/topics/textpattern-development) (for development resources) -## Additional development tools - -Various components used within Textpattern (such as the bundled themes and language translations) are maintained in standalone repositories. Textpattern has a simple development toolset built on [Node.js](https://nodejs.org/) to pull the distribution files of those repositories into the core as required. - -You can install Node.js using the [installer](https://nodejs.org/en/download/) or [package manager](https://nodejs.org/en/download/package-manager/). - -Install required dev tools: - -```ShellSession -npm install -``` - -You can then pull the following components from the CLI, like so: - -```ShellSession -npm run get-default-theme -npm run get-classic-admin-theme -npm run get-hive-admin-theme -npm run get-pophelp -npm run get-textpacks -npm run get-dependencies -``` - -To request a specific tag or branch: - -```ShellSession -npm run get-default-theme 4.8.8 -npm run get-classic-admin-theme 4.8.8 -npm run get-classic-admin-theme 4.8.x -npm run get-hive-admin-theme 4.8.x -npm run get-textpacks 4.8.x -``` - -Release tools: - -Usage: `npm run txp-gitdist [dest-dir]` (`dest-dir` defaults to a -temporary location). - -```ShellSession -npm run txp-index -npm run txp-checksums -npm run txp-gitdist 1.2.3 ../my-dest-dir -``` - ## Thank You Thank you to our [GitHub sponsors](https://github.com/sponsors/textpattern). Your continued support is greatly appreciated! diff --git a/textpattern/setup/articles/articles.welcome.xml b/textpattern/setup/default-content/en-gb/articles/articles.welcome.xml similarity index 100% rename from textpattern/setup/articles/articles.welcome.xml rename to textpattern/setup/default-content/en-gb/articles/articles.welcome.xml diff --git a/textpattern/setup/data/core.prefs b/textpattern/setup/default-content/en-gb/data/core.prefs similarity index 100% rename from textpattern/setup/data/core.prefs rename to textpattern/setup/default-content/en-gb/data/core.prefs diff --git a/textpattern/setup/default-content/en-gb/data/txp_category.xml b/textpattern/setup/default-content/en-gb/data/txp_category.xml new file mode 100644 index 0000000000..12d7f50589 --- /dev/null +++ b/textpattern/setup/default-content/en-gb/data/txp_category.xml @@ -0,0 +1,33 @@ + + + + + everything-is-going-to-be-alright + article + root + Everything is going to be alright + + + + hope-for-the-future + article + root + Hope for the future + + + + meaningful-labour + article + root + Meaningful labour + + + + textpattern + link + root + Textpattern + + + + diff --git a/textpattern/setup/data/txp_link.xml b/textpattern/setup/default-content/en-gb/data/txp_link.xml similarity index 83% rename from textpattern/setup/data/txp_link.xml rename to textpattern/setup/default-content/en-gb/data/txp_link.xml index d862ccb261..5f3e3c0388 100644 --- a/textpattern/setup/data/txp_link.xml +++ b/textpattern/setup/default-content/en-gb/data/txp_link.xml @@ -7,8 +7,8 @@ https://textpattern.com/ Textpattern website 10 - - + + NOW() @@ -16,8 +16,8 @@ https://docs.textpattern.com/ Textpattern user documentation 20 - - + + NOW() @@ -25,8 +25,8 @@ https://textpattern.com/github Textpattern on GitHub 30 - - + + NOW() @@ -34,8 +34,8 @@ https://textpattern.com/mastodon Textpattern on Mastodon 40 - - + + NOW() diff --git a/textpattern/setup/data/txp_section.xml b/textpattern/setup/default-content/en-gb/data/txp_section.xml similarity index 100% rename from textpattern/setup/data/txp_section.xml rename to textpattern/setup/default-content/en-gb/data/txp_section.xml diff --git a/textpattern/setup/default-content/en-us/articles/articles.welcome.xml b/textpattern/setup/default-content/en-us/articles/articles.welcome.xml new file mode 100644 index 0000000000..db0dd4c1fc --- /dev/null +++ b/textpattern/setup/default-content/en-us/articles/articles.welcome.xml @@ -0,0 +1,21 @@ + + + +
+ Welcome to Textpattern +
articles
+ hope-for-the-future + meaningful-labor + + + + Donald Swain + donald.swain@example.com + https://docs.textpattern.com/brand/donald-swain + I enjoy your site very much.

]]>
+
+
+
+
diff --git a/textpattern/setup/default-content/en-us/data/core.prefs b/textpattern/setup/default-content/en-us/data/core.prefs new file mode 100644 index 0000000000..0fce2b23a9 --- /dev/null +++ b/textpattern/setup/default-content/en-us/data/core.prefs @@ -0,0 +1,23 @@ +{ + "default_section": { + "val": "articles", + "type": "2", + "event": "section", + "html": "text_input", + "position": "0" + }, + "custom_1_set": { + "val": "custom1", + "type": "0", + "event": "custom", + "html": "custom_set", + "position": "1" + }, + "custom_2_set": { + "val": "custom2", + "type": "0", + "event": "custom", + "html": "custom_set", + "position": "2" + } +} diff --git a/textpattern/setup/data/txp_category.xml b/textpattern/setup/default-content/en-us/data/txp_category.xml similarity index 84% rename from textpattern/setup/data/txp_category.xml rename to textpattern/setup/default-content/en-us/data/txp_category.xml index 31d8b4f7cf..2df24dc8d2 100644 --- a/textpattern/setup/data/txp_category.xml +++ b/textpattern/setup/default-content/en-us/data/txp_category.xml @@ -6,28 +6,28 @@ article root Everything is going to be alright - +
hope-for-the-future article root Hope for the future - + meaningful-labor article root Meaningful labor - + textpattern link root Textpattern - + diff --git a/textpattern/setup/default-content/en-us/data/txp_link.xml b/textpattern/setup/default-content/en-us/data/txp_link.xml new file mode 100644 index 0000000000..9f8a81c4cc --- /dev/null +++ b/textpattern/setup/default-content/en-us/data/txp_link.xml @@ -0,0 +1,41 @@ + + + + + NOW() + textpattern + https://textpattern.com/ + Textpattern website + 10 + + + + + NOW() + textpattern + https://docs.textpattern.com/ + Textpattern user documentation + 20 + + + + + NOW() + textpattern + https://textpattern.com/github + Textpattern on GitHub + 30 + + + + + NOW() + textpattern + https://textpattern.com/@textpattern + Textpattern on Twitter + 40 + + + + + diff --git a/textpattern/setup/default-content/en-us/data/txp_section.xml b/textpattern/setup/default-content/en-us/data/txp_section.xml new file mode 100644 index 0000000000..c37d02b4e3 --- /dev/null +++ b/textpattern/setup/default-content/en-us/data/txp_section.xml @@ -0,0 +1,15 @@ + + +
+ + articles + archive + default + + 1 + 1 + 1 + Articles + +
+
diff --git a/textpattern/setup/default-content/en/articles/articles.welcome.xml b/textpattern/setup/default-content/en/articles/articles.welcome.xml new file mode 100644 index 0000000000..d8a4f9c3cf --- /dev/null +++ b/textpattern/setup/default-content/en/articles/articles.welcome.xml @@ -0,0 +1,21 @@ + + + +
+ Welcome to Textpattern +
articles
+ hope-for-the-future + meaningful-labour + + + + Donald Swain + donald.swain@example.com + https://docs.textpattern.com/brand/donald-swain + I enjoy your site very much.

]]>
+
+
+
+
diff --git a/textpattern/setup/default-content/en/data/core.prefs b/textpattern/setup/default-content/en/data/core.prefs new file mode 100644 index 0000000000..0fce2b23a9 --- /dev/null +++ b/textpattern/setup/default-content/en/data/core.prefs @@ -0,0 +1,23 @@ +{ + "default_section": { + "val": "articles", + "type": "2", + "event": "section", + "html": "text_input", + "position": "0" + }, + "custom_1_set": { + "val": "custom1", + "type": "0", + "event": "custom", + "html": "custom_set", + "position": "1" + }, + "custom_2_set": { + "val": "custom2", + "type": "0", + "event": "custom", + "html": "custom_set", + "position": "2" + } +} diff --git a/textpattern/setup/default-content/en/data/txp_category.xml b/textpattern/setup/default-content/en/data/txp_category.xml new file mode 100644 index 0000000000..12d7f50589 --- /dev/null +++ b/textpattern/setup/default-content/en/data/txp_category.xml @@ -0,0 +1,33 @@ + + + + + everything-is-going-to-be-alright + article + root + Everything is going to be alright + + + + hope-for-the-future + article + root + Hope for the future + + + + meaningful-labour + article + root + Meaningful labour + + + + textpattern + link + root + Textpattern + + + + diff --git a/textpattern/setup/default-content/en/data/txp_link.xml b/textpattern/setup/default-content/en/data/txp_link.xml new file mode 100644 index 0000000000..9f8a81c4cc --- /dev/null +++ b/textpattern/setup/default-content/en/data/txp_link.xml @@ -0,0 +1,41 @@ + + + + + NOW() + textpattern + https://textpattern.com/ + Textpattern website + 10 + + + + + NOW() + textpattern + https://docs.textpattern.com/ + Textpattern user documentation + 20 + + + + + NOW() + textpattern + https://textpattern.com/github + Textpattern on GitHub + 30 + + + + + NOW() + textpattern + https://textpattern.com/@textpattern + Textpattern on Twitter + 40 + + + + + diff --git a/textpattern/setup/default-content/en/data/txp_section.xml b/textpattern/setup/default-content/en/data/txp_section.xml new file mode 100644 index 0000000000..c37d02b4e3 --- /dev/null +++ b/textpattern/setup/default-content/en/data/txp_section.xml @@ -0,0 +1,15 @@ + + +
+ + articles + archive + default + + 1 + 1 + 1 + Articles + +
+
diff --git a/textpattern/setup/default-content/fr/articles/articles.welcome.xml b/textpattern/setup/default-content/fr/articles/articles.welcome.xml new file mode 100644 index 0000000000..5cafc7b9b5 --- /dev/null +++ b/textpattern/setup/default-content/fr/articles/articles.welcome.xml @@ -0,0 +1,21 @@ + + + +
+ Bienvenue sur Textpattern +
articles
+ espoir-pour-le-futur + travail-significatif + + + + Donald Swain + donald.swain@example.com + https://docs.textpattern.com/brand/donald-swain + J’aime beaucoup votre site.

]]>
+
+
+
+
diff --git a/textpattern/setup/default-content/fr/data/core.prefs b/textpattern/setup/default-content/fr/data/core.prefs new file mode 100644 index 0000000000..1d94b76e6a --- /dev/null +++ b/textpattern/setup/default-content/fr/data/core.prefs @@ -0,0 +1,23 @@ +{ + "default_section": { + "val": "articles", + "type": "2", + "event": "section", + "html": "text_input", + "position": "0" + }, + "custom_1_set": { + "val": "personnalisé1", + "type": "0", + "event": "custom", + "html": "custom_set", + "position": "1" + }, + "custom_2_set": { + "val": "personnalisé2", + "type": "0", + "event": "custom", + "html": "custom_set", + "position": "2" + } +} diff --git a/textpattern/setup/default-content/fr/data/txp_category.xml b/textpattern/setup/default-content/fr/data/txp_category.xml new file mode 100644 index 0000000000..26d11ef2d2 --- /dev/null +++ b/textpattern/setup/default-content/fr/data/txp_category.xml @@ -0,0 +1,33 @@ + + + + + tout-ira-bien + article + root + Tout ira bien + + + + espoir-pour-le-futur + article + root + Espoir pour le futur + + + + travail-significatif + article + root + Travail significatif + + + + textpattern + link + root + Textpattern + + + + diff --git a/textpattern/setup/default-content/fr/data/txp_link.xml b/textpattern/setup/default-content/fr/data/txp_link.xml new file mode 100644 index 0000000000..621999be19 --- /dev/null +++ b/textpattern/setup/default-content/fr/data/txp_link.xml @@ -0,0 +1,41 @@ + + + + + NOW() + textpattern + https://textpattern.com/ + Site officiel de Textpattern + 10 + + + + + NOW() + textpattern + https://docs.textpattern.com/ + Documentation utilisateur de Textpattern + 20 + + + + + NOW() + textpattern + https://textpattern.com/github + Textpattern sur GitHub + 30 + + + + + NOW() + textpattern + https://textpattern.com/@textpattern + Textpattern sur Twitter + 40 + + + + + diff --git a/textpattern/setup/default-content/fr/data/txp_section.xml b/textpattern/setup/default-content/fr/data/txp_section.xml new file mode 100644 index 0000000000..c37d02b4e3 --- /dev/null +++ b/textpattern/setup/default-content/fr/data/txp_section.xml @@ -0,0 +1,15 @@ + + +
+ + articles + archive + default + + 1 + 1 + 1 + Articles + +
+
diff --git a/textpattern/vendors/Textpattern/DB/Data/txp_category.xml b/textpattern/vendors/Textpattern/DB/Data/txp_category.xml index d616846cde..241ed42183 100644 --- a/textpattern/vendors/Textpattern/DB/Data/txp_category.xml +++ b/textpattern/vendors/Textpattern/DB/Data/txp_category.xml @@ -6,28 +6,28 @@ article root - + root link root - + root image root - + root file root - +