Merge branch 'master' into feature/style-polish-2

* master: (21 commits) Add typescript-tslint-plugin Add CSS class for at Mention Add redux error logging Fix tests and focus stealing when highlighting code Update quill module type defintion Fix importing stylesheets in test builds Remove unnecessarily overriden block-blot Fix doc block on Smarty homepage title function Happy new year 🎉 Add optionalize utility type Update server recommendations section of README Add some missing periods to the README & update a version number Add "Self-Hosting Basics" section to README Add prevention of editor change from firing after initializing Fix back button styling in frame header Have QueryString updates execute synchronously Move navigation manager SCSS out of core Update server rendered blocks to use <pre> Add code highlighting in the editor Implement code highlighting for rendered content ... # Conflicts: # library/src/scss/components/_dateInput.scss
vanilla · Jan 4, 2019 · 16b05c3 · 16b05c3
2 parents d8a6fb4 + 3009daa
commit 16b05c3
Show file tree

Hide file tree

Showing 1,072 changed files with 1,361 additions and 1,467 deletions.
diff --git a/README.md b/README.md
@@ -26,7 +26,7 @@ Vanilla is free, open source software distributed under the GNU GPL2.
 We accept and encourage contributions from our community and sometimes give hugs in return.
 You can join us on the [Vanilla Community Forums](https://open.vanillaforums.com/discussions) to be part of that discussion.
 
-The latest stable release is always [listed here](https://open.vanillaforums.com/addon/vanilla-core). Currently, it is the `release/2.5` branch.
+The latest stable release is always [listed here](https://open.vanillaforums.com/addon/vanilla-core). Currently, it is the `release/2.6` branch.
 
 New plugins and themes can be listed in the [Official Addon Directory](https://open.vanillaforums.com/addon/).
 We encourage addon developers to release their code under the GPL as well, but do not require it.
@@ -40,14 +40,25 @@ you can skip the rest of this technical stuff and [go there directly](https://va
 
 If you professionally run a large community or enterprise forum, our cloud solution will make the best technical and economic sense by far.
 
+## Self-Hosting Basics
+
+If you're new to self-hosting, read this section. Otherwise, skip to the [requirements](https://github.com/vanilla/vanilla/blob/master/README.md#self-hosting-requirements) and [installation](https://github.com/vanilla/vanilla/blob/master/README.md#installation).
+
+Vanilla requires a server with PHP, MySQL, and web server software (like Apache or nginx). You'll probably need to own a domain, and already have it configured on your server with DNS. You usually need to create a database for it via your hosting provider, often via phpMyAdmin. Then you'll need to visit that domain after uploading Vanilla to continue installation. Up to this point, your web host is responsible for all these things. You should consult their docs and contact their support with any questions to getting as far as that.
+
+Say you bought some web space and someone told you how to access it. It might be that you bought a domain like `example.com` or you received only a cryptic sub domain of your provider like `abc123456789.yourwebhoster.com` or you might only have received an IP address, so that you can reach your web space with `1.2.3.4`.
+
+When you enter one of those to reach your web host, your web server shows what is in a folder of your web space. Often, that folder is called `public_html`. Say you own `example.com` and that's what you set up on your server. You have created a subfolder called `forum` (always use lowercase letters!) and uploaded Vanilla to it (see [installation below]((https://github.com/vanilla/vanilla/blob/master/README.md#installation)). Then, you will be able to see the Vanilla installer when you visit `example.com/forum` in your browser.
+
 ## Self-Hosting Requirements
 
 We strongly recommend:
 
-*  **PHP 7.1** or higher.
-*  MySQL 5.6 or higher (or Percona/MariaDB equivalent).
+*  **PHP 7.2** or higher.
+*  MySQL 5.7 or higher (or Percona/MariaDB equivalent).
+* SSL encyrption (check out [LetsEncrypt](https://letsencrypt.org/)).
 
-If your server is not running PHP 7.1 or higher, **you should address this soon**. While PHP 7.0 will receive security patches until December 2018, Vanilla may end support for it prior to that.
+If your server is not running PHP 7.1 or higher, **you should address this soon**. PHP 7.0 has reached end of life and will no longer receive security patches. **Vanilla's support for PHP 7.0 will end soon**.
 
 Our _minimum_ requirements are now:
 
@@ -58,7 +69,7 @@ Our _minimum_ requirements are now:
 * MySQL 5.0 or newer (or Percona/MariaDB equivalent).
 * MySQL strict mode [disabled](https://www.liquidweb.com/kb/how-to-disable-mysql-strict-mode/).
 
-Vanilla ships with a `.htaccess` file required for Apache support. Using nginx or IIS may require additional configuration.
+Vanilla ships with a `.htaccess` file required for Apache support. Using nginx or IIS may require additional configuration. We have [docs for nginx](https://docs.vanillaforums.com/developer/backend/server-nginx/).
 
 On the client side, Vanilla should run & look good in just about any modern browser.
 Still using IE? How exotic. You'll want IE11 or greater. IE8 *might* work if you squint hard and click gently, but we make no promises.
@@ -161,7 +172,7 @@ The creators of git flow released a [short intro video](http://vimeo.com/1601841
 The `master` branch is production-ready for our cloud product but is not yet vetted for open source release (alternate platforms & configurations).
 Reviewed, stable changes land against `master` via pull-request.
 
-Our open source release branches are named by version number, e.g. `release/2.5`.
+Our open source release branches are named by version number, e.g. `release/2.6`.
 We begin release branches with a beta (b1) designation and progress them thru release candidate to stable.
 All open source releases (included pre-releases) are tagged.
 
@@ -172,7 +183,7 @@ We'll work on releasing an updated version as quickly as possible.
 Please do not email non-security issues; use the [issue tracker](https://github.com/vanilla/vanilla/issues) instead.
 
 ## Legal Stuff
-Copyright &copy; 2009-2018 Vanilla Forums Inc.
+Copyright &copy; 2009-2019 Vanilla Forums Inc.
 
 Vanilla Forums is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License
 as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version.

diff --git a/applications/conversations/controllers/api/ConversationsApiController.php b/applications/conversations/controllers/api/ConversationsApiController.php
@@ -1,7 +1,7 @@
 <?php
 /**
  * @author Alexandre (DaazKu) Chouinard <alexandre.c@vanillaforums.com>
- * @copyright 2009-2018 Vanilla Forums Inc.
+ * @copyright 2009-2019 Vanilla Forums Inc.
  * @license GPL-2.0-only
  */
 

diff --git a/applications/conversations/controllers/api/MessagesApiController.php b/applications/conversations/controllers/api/MessagesApiController.php
@@ -1,7 +1,7 @@
 <?php
 /**
  * @author Alexandre (DaazKu) Chouinard <alexandre.c@vanillaforums.com>
- * @copyright 2009-2018 Vanilla Forums Inc.
+ * @copyright 2009-2019 Vanilla Forums Inc.
  * @license GPL-2.0-only
  */
 

diff --git a/applications/conversations/controllers/class.conversationscontroller.php b/applications/conversations/controllers/class.conversationscontroller.php
@@ -2,7 +2,7 @@
 /**
  * Conversations controller.
  *
- * @copyright 2009-2018 Vanilla Forums Inc.
+ * @copyright 2009-2019 Vanilla Forums Inc.
  * @license GPL-2.0-only
  * @package Conversations
  * @since 2.0

diff --git a/applications/conversations/controllers/class.messagescontroller.php b/applications/conversations/controllers/class.messagescontroller.php
@@ -2,7 +2,7 @@
 /**
  * Messages controller.
  *
- * @copyright 2009-2018 Vanilla Forums Inc.
+ * @copyright 2009-2019 Vanilla Forums Inc.
  * @license GPL-2.0-only
  * @package Conversations
  * @since 2.0

diff --git a/applications/conversations/locale/en.php b/applications/conversations/locale/en.php
@@ -2,7 +2,7 @@
 /**
  * Conversations default locale.
  *
- * @copyright 2009-2018 Vanilla Forums Inc.
+ * @copyright 2009-2019 Vanilla Forums Inc.
  * @license GPL-2.0-only
  * @package Conversations
  * @since 2.0

diff --git a/applications/conversations/models/class.conversationmessagemodel.php b/applications/conversations/models/class.conversationmessagemodel.php
@@ -2,7 +2,7 @@
 /**
  * Conversation message model.
  *
- * @copyright 2009-2018 Vanilla Forums Inc.
+ * @copyright 2009-2019 Vanilla Forums Inc.
  * @license GPL-2.0-only
  * @package Conversations
  * @since 2.0

diff --git a/applications/conversations/models/class.conversationmodel.php b/applications/conversations/models/class.conversationmodel.php
@@ -2,7 +2,7 @@
 /**
  * Conversation model.
  *
- * @copyright 2009-2018 Vanilla Forums Inc.
+ * @copyright 2009-2019 Vanilla Forums Inc.
  * @license GPL-2.0-only
  * @package Conversations
  * @since 2.0

diff --git a/applications/conversations/models/class.conversationsmodel.php b/applications/conversations/models/class.conversationsmodel.php
@@ -2,7 +2,7 @@
 /**
  * Conversations model.
  *
- * @copyright 2009-2018 Vanilla Forums Inc.
+ * @copyright 2009-2019 Vanilla Forums Inc.
  * @license GPL-2.0-only
  * @package Conversations
  * @since 2.0

diff --git a/applications/conversations/modules/class.addpeoplemodule.php b/applications/conversations/modules/class.addpeoplemodule.php
@@ -2,7 +2,7 @@
 /**
  * Add People module.
  *
- * @copyright 2009-2018 Vanilla Forums Inc.
+ * @copyright 2009-2019 Vanilla Forums Inc.
  * @license GPL-2.0-only
  * @package Conversations
  * @since 2.0

diff --git a/applications/conversations/modules/class.clearhistorymodule.php b/applications/conversations/modules/class.clearhistorymodule.php
@@ -2,7 +2,7 @@
 /**
  * Clear History module.
  *
- * @copyright 2009-2018 Vanilla Forums Inc.
+ * @copyright 2009-2019 Vanilla Forums Inc.
  * @license GPL-2.0-only
  * @package Conversations
  * @since 2.0

diff --git a/applications/conversations/modules/class.inboxmodule.php b/applications/conversations/modules/class.inboxmodule.php
@@ -2,7 +2,7 @@
 /**
  * Inbox module.
  *
- * @copyright 2009-2018 Vanilla Forums Inc.
+ * @copyright 2009-2019 Vanilla Forums Inc.
  * @license GPL-2.0-only
  * @package Conversations
  * @since 2.0

diff --git a/applications/conversations/modules/class.inthisconversationmodule.php b/applications/conversations/modules/class.inthisconversationmodule.php
@@ -2,7 +2,7 @@
 /**
  * In This Conversation module.
  *
- * @copyright 2009-2018 Vanilla Forums Inc.
+ * @copyright 2009-2019 Vanilla Forums Inc.
  * @license GPL-2.0-only
  * @package Conversations
  * @since 2.0

diff --git a/applications/conversations/modules/class.newconversationmodule.php b/applications/conversations/modules/class.newconversationmodule.php
@@ -2,7 +2,7 @@
 /**
  * New Conversation module.
  *
- * @copyright 2009-2018 Vanilla Forums Inc.
+ * @copyright 2009-2019 Vanilla Forums Inc.
  * @license GPL-2.0-only
  * @package Conversations
  * @since 2.0

diff --git a/applications/conversations/settings/class.hooks.php b/applications/conversations/settings/class.hooks.php
@@ -2,7 +2,7 @@
 /**
  * Hooks for Conversations.
  *
- * @copyright 2009-2018 Vanilla Forums Inc.
+ * @copyright 2009-2019 Vanilla Forums Inc.
  * @license GPL-2.0-only
  * @package Conversations
  * @since 2.0

diff --git a/applications/conversations/settings/structure.php b/applications/conversations/settings/structure.php
@@ -2,7 +2,7 @@
 /**
  * Conversations database structure.
  *
- * @copyright 2009-2018 Vanilla Forums Inc.
+ * @copyright 2009-2019 Vanilla Forums Inc.
  * @license GPL-2.0-only
  * @package Conversations
  * @since 2.0

diff --git a/applications/conversations/settings/stub.php b/applications/conversations/settings/stub.php
@@ -4,7 +4,7 @@
  *
  * Called by ConversationsHooks::setup() to insert stub content upon enabling app.
  *
- * @copyright 2009-2018 Vanilla Forums Inc.
+ * @copyright 2009-2019 Vanilla Forums Inc.
  * @license GPL-2.0-only
  * @package Conversations
  * @since 2.2

diff --git a/applications/dashboard/controllers/api/AbstractApiController.php b/applications/dashboard/controllers/api/AbstractApiController.php
@@ -1,7 +1,7 @@
 <?php
 /**
  * @author Todd Burry <todd@vanillaforums.com>
- * @copyright 2009-2018 Vanilla Forums Inc.
+ * @copyright 2009-2019 Vanilla Forums Inc.
  * @license GPL-2.0-only
  */
 

diff --git a/applications/dashboard/controllers/api/AddonsApiController.php b/applications/dashboard/controllers/api/AddonsApiController.php
@@ -2,7 +2,7 @@
 
 /**
  * @author Todd Burry <todd@vanillaforums.com>
- * @copyright 2009-2018 Vanilla Forums Inc.
+ * @copyright 2009-2019 Vanilla Forums Inc.
  * @license GPL-2.0-only
  */
 

diff --git a/applications/dashboard/controllers/api/ApplicantsApiController.php b/applications/dashboard/controllers/api/ApplicantsApiController.php
@@ -1,6 +1,6 @@
 <?php
 /**
-* @copyright 2009-2018 Vanilla Forums Inc.
+* @copyright 2009-2019 Vanilla Forums Inc.
 * @license GPLv2
 */
 

diff --git a/applications/dashboard/controllers/api/AuthenticateApiController.php b/applications/dashboard/controllers/api/AuthenticateApiController.php
@@ -1,7 +1,7 @@
 <?php
 /**
  * @author Alexandre (DaazKu) Chouinard <alexandre.c@vanillaforums.com>
- * @copyright 2009-2018 Vanilla Forums Inc.
+ * @copyright 2009-2019 Vanilla Forums Inc.
  * @license GPL-2.0-only
  */
 

diff --git a/applications/dashboard/controllers/api/AuthenticatorsApiController.php b/applications/dashboard/controllers/api/AuthenticatorsApiController.php
@@ -1,7 +1,7 @@
 <?php
 /**
  * @author Alexandre (DaazKu) Chouinard <alexandre.c@vanillaforums.com>
- * @copyright 2009-2018 Vanilla Forums Inc.
+ * @copyright 2009-2019 Vanilla Forums Inc.
  * @license GPL-2.0-only
  */
 

diff --git a/applications/dashboard/controllers/api/DashboardApiController.php b/applications/dashboard/controllers/api/DashboardApiController.php
@@ -1,7 +1,7 @@
 <?php
 /**
  * @author Todd Burry <todd@vanillaforums.com>
- * @copyright 2009-2018 Vanilla Forums Inc.
+ * @copyright 2009-2019 Vanilla Forums Inc.
  * @license GPL-2.0-only
  */
 

diff --git a/applications/dashboard/controllers/api/InvitesApiController.php b/applications/dashboard/controllers/api/InvitesApiController.php
@@ -1,6 +1,6 @@
 <?php
 /**
- * @copyright 2009-2018 Vanilla Forums Inc.
+ * @copyright 2009-2019 Vanilla Forums Inc.
  * @license GPL-2.0-only
  */
 

diff --git a/applications/dashboard/controllers/api/LocalesApiController.php b/applications/dashboard/controllers/api/LocalesApiController.php
@@ -1,7 +1,7 @@
 <?php
 /**
  * @author Todd Burry <todd@vanillaforums.com>
- * @copyright 2009-2018 Vanilla Forums Inc.
+ * @copyright 2009-2019 Vanilla Forums Inc.
  * @license GPL-2.0-only
  */
 

diff --git a/applications/dashboard/controllers/api/MediaApiController.php b/applications/dashboard/controllers/api/MediaApiController.php
@@ -1,6 +1,6 @@
 <?php
 /**
- * @copyright 2009-2018 Vanilla Forums Inc.
+ * @copyright 2009-2019 Vanilla Forums Inc.
  * @license GPL-2.0-only
  */
 

diff --git a/applications/dashboard/controllers/api/NotificationsApiController.php b/applications/dashboard/controllers/api/NotificationsApiController.php
@@ -1,6 +1,6 @@
 <?php
 /**
- * @copyright 2009-2018 Vanilla Forums Inc.
+ * @copyright 2009-2019 Vanilla Forums Inc.
  * @license GPL-2.0-only
  */
 

diff --git a/applications/dashboard/controllers/api/OpenApiApiController.php b/applications/dashboard/controllers/api/OpenApiApiController.php
@@ -1,7 +1,7 @@
 <?php
 /**
  * @author Todd Burry <todd@vanillaforums.com>
- * @copyright 2009-2018 Vanilla Forums Inc.
+ * @copyright 2009-2019 Vanilla Forums Inc.
  * @license GPL-2.0-only
  */
 

diff --git a/applications/dashboard/controllers/api/RolesApiController.php b/applications/dashboard/controllers/api/RolesApiController.php
@@ -1,6 +1,6 @@
 <?php
 /**
- * @copyright 2009-2018 Vanilla Forums Inc.
+ * @copyright 2009-2019 Vanilla Forums Inc.
  * @license GPL-2.0-only
  */
 

diff --git a/applications/dashboard/controllers/api/TokensApiController.php b/applications/dashboard/controllers/api/TokensApiController.php
@@ -1,6 +1,6 @@
 <?php
 /**
- * @copyright 2009-2018 Vanilla Forums Inc.
+ * @copyright 2009-2019 Vanilla Forums Inc.
  * @license GPL-2.0-only
  */
 

diff --git a/applications/dashboard/controllers/api/UsersApiController.php b/applications/dashboard/controllers/api/UsersApiController.php
@@ -1,6 +1,6 @@
 <?php
 /**
- * @copyright 2009-2018 Vanilla Forums Inc.
+ * @copyright 2009-2019 Vanilla Forums Inc.
  * @license GPL-2.0-only
  */
 

diff --git a/applications/dashboard/controllers/class.activitycontroller.php b/applications/dashboard/controllers/class.activitycontroller.php
@@ -2,7 +2,7 @@
 /**
  * Manages the activity stream.
  *
- * @copyright 2009-2018 Vanilla Forums Inc.
+ * @copyright 2009-2019 Vanilla Forums Inc.
  * @license GPL-2.0-only
  * @package Dashboard
  * @since 2.0

diff --git a/applications/dashboard/controllers/class.addoncachecontroller.php b/applications/dashboard/controllers/class.addoncachecontroller.php
@@ -2,7 +2,7 @@
 /**
  * Provides endpoint for interfacing with the addon cache.
  *
- * @copyright 2009-2018 Vanilla Forums Inc.
+ * @copyright 2009-2019 Vanilla Forums Inc.
  * @license GPL-2.0-only
  * @package Dashboard
  * @since 2.4

diff --git a/applications/dashboard/controllers/class.assetcontroller.php b/applications/dashboard/controllers/class.assetcontroller.php
@@ -2,7 +2,7 @@
 /**
  * Manages asset endpoints.
  *
- * @copyright 2009-2018 Vanilla Forums Inc.
+ * @copyright 2009-2019 Vanilla Forums Inc.
  * @license GPL-2.0-only
  * @package Dashboard
  * @since 2.0

diff --git a/applications/dashboard/controllers/class.authenticatecontroller.php b/applications/dashboard/controllers/class.authenticatecontroller.php
@@ -1,7 +1,7 @@
 <?php
 /**
  * @author Alexandre (DaazKu) Chouinard <alexandre.c@vanillaforums.com>
- * @copyright 2009-2018 Vanilla Forums Inc.
+ * @copyright 2009-2019 Vanilla Forums Inc.
  * @license GPL-2.0-only
  */
 

diff --git a/applications/dashboard/controllers/class.dashboardcontroller.php b/applications/dashboard/controllers/class.dashboardcontroller.php
@@ -2,7 +2,7 @@
 /**
  * Master application controller for Dashboard, extended by most others.
  *
- * @copyright 2009-2018 Vanilla Forums Inc.
+ * @copyright 2009-2019 Vanilla Forums Inc.
  * @license GPL-2.0-only
  * @package Dashboard
  * @since 2.0

diff --git a/applications/dashboard/controllers/class.dbacontroller.php b/applications/dashboard/controllers/class.dbacontroller.php
@@ -2,7 +2,7 @@
 /**
  * Contains useful functions for cleaning up the database.
  *
- * @copyright 2009-2018 Vanilla Forums Inc.
+ * @copyright 2009-2019 Vanilla Forums Inc.
  * @license GPL-2.0-only
  * @package Dashboard
  * @since 2.1

diff --git a/applications/dashboard/controllers/class.embedcontroller.php b/applications/dashboard/controllers/class.embedcontroller.php
@@ -2,7 +2,7 @@
 /**
  * Manages the embedding of a forum on a foreign page.
  *
- * @copyright 2009-2018 Vanilla Forums Inc.
+ * @copyright 2009-2019 Vanilla Forums Inc.
  * @license GPL-2.0-only
  * @package Dashboard
  * @since 2.0.18

diff --git a/applications/dashboard/controllers/class.entrycontroller.php b/applications/dashboard/controllers/class.entrycontroller.php
@@ -2,7 +2,7 @@
 /**
  * Manages users manually authenticating (signing in).
  *
- * @copyright 2009-2018 Vanilla Forums Inc.
+ * @copyright 2009-2019 Vanilla Forums Inc.
  * @license GPL-2.0-only
  * @package Dashboard
  * @since 2.0