vendor and env first commit

vendor/vanguardapp/announcements/readme.md

@@ -0,0 +1,97 @@
+📢 Announcements plugin for [Vanguard - Advanced PHP Login and User Management](https://vanguardapp.io)
+system.
+
+## Installation
+
+This plugin requires Vanguard `4.0.0` or greater.
+
+### Installation via Composer
+
+To install the plugin first you will need to pull it via composer 
+by running the following command
+
+```
+composer require vanguardapp/announcements
+```
+
+The composer will install the plugin for you as well as it's dependencies.
+
+The next step is to register the plugin by adding the 
+`\Vanguard\Announcements\Announcements::class` 
+to the list of Vanguard plugins inside the `VanguardServiceProvider`:
+
+```php
+protected function plugins()
+    {
+        return [
+            //...
+            \Vanguard\Announcements\Announcements::class,
+        ];
+    }
+```
+
+As soon as your plugin is registered, you should publish the 
+plugins static assets and migrations by running the following command:
+
+```
+php artisan vendor:publish --provider="Vanguard\Announcements\Announcements" --tag="public" --tag="migrations"
+```
+
+And, as the last step of the installation, you will need to
+run the following commands to make all the necessary database modifications:
+
+```
+php artisan migrate
+php artisan db:seed --class="AnnouncementsDatabaseSeeder"
+```
+
+At this point the plugin will be fully installed and ready to go.
+
+### Manual Installation
+
+If you plan to make the modifications to the plugin and customize it to
+fit your needs, it's much easier if you add it to your project manually.
+
+To do so, you will need to download the ZIP archive from GitHub
+by clicking the green "Clone or download" button and then choosing
+the "Download ZIP" option from the dropdown.
+
+Once you have the ZIP file on your computer, extract it to the 
+`plugins/Announcements` folder (you will need to create this folder
+since it probably won't be present in your Vanguard installation).
+
+Next step is to update your main `composer.json` file located in 
+Vanguard's root directory and add the following object to the `repositories`
+array:
+
+```
+{
+    "type": "path",
+    "url": "./plugins/Announcements"
+}
+```
+
+This will tell the composer that your plugin is located in `/plugins/Announcements`
+directory and that it should be installed from there. 
+
+Now, add the following to the composer's `require` section 
+
+```
+"vanguardapp/announcements": "*"
+```
+
+And run `composer update`.
+
+Composer will now install the plugin from your local directory instead
+of pulling it from GitHub, which means that you will be able to make 
+the changes to the plugin itself and customize it to fit your needs.
+
+The rest of the process is the same as when the plugin is installed 
+by directly fetching it via composer from the GitHub repository, so you
+will need to do all the same steps as above, which in short involves 
+updating the `VanguardServiceProvider` and running the commands to 
+publish plugin's static assets and to update the database.
+
+## License
+
+This plugin is an open-source software licensed under the [MIT license](https://opensource.org/licenses/MIT).