README

A module for SeAT that makes your life with corporation buyback programs a lot easier.

Screenshots

Permissions

There are three different types of permissions you can give to your members:

Request

This is the default right a corp mate needs to access the buyback module. This permission includes the "Request" and "My Contracts" section.

Contract

This permission is for all corp mates that are allowed to manage the corp buyback requests / contracts.

Admin

This permission gives access to the admin section. Here you can adjust some general plugin settings and configure the buyback item settings.

Usage

User:

1. Copy & Paste your items you want to sell into the form under request.
2. If everything is fine create the contract in EVE with the details shown on the right
3. Click on Confirm. Done. You will be redirected to the "My Buyback" showing you created buyback.
4. Contract-Manager: Under "Contracts" you can see all created contracts and are able to delete or finish them after you have compared them with the ingame contract of the corp mate.The random generated ID will help you to find contracts faster.

⚠️ The buyback will only be saved with the click on "Confirm". Created contracts in EVE can not be seen by the plugin.

⚠️ Each item price is cached and only refreshed by default every hour. You can change the cache time over the admin section. Please do not set this value too low because this would spam the chosen price provider api and your server could get banned for a while.

Discord Notifications

You are able to receive on every new buyback request discord notification over a discord webhook url directly into a discord channel. By default, the discord notification are turned off. You have to provide a valid discord webhook url over the admin settings page first.

How can I get my channel webhook url? Webhook Url Guide

Example:

Quick Installation Guide:

I can also recommend reading through the official seat documentation.

Install

Switch to your seat installation directory ( default : /var/www/seat)

sudo -H -u www-data bash -c 'php artisan down'
sudo -H -u www-data bash -c 'composer require hermesdj/seat-buyback'
sudo -H -u www-data bash -c 'php artisan vendor:publish --force --all'
sudo -H -u www-data bash -c 'php artisan migrate'
sudo -H -u www-data bash -c 'php artisan seat:cache:clear'
sudo -H -u www-data bash -c 'php artisan config:cache'
sudo -H -u www-data bash -c 'php artisan route:cache'
sudo -H -u www-data bash -c 'php artisan up'

*Note that www-data is the default ubuntu webserver user. If you are running on a different distribution please adjust the user.

Docker Install

Open your .env file and edit the SEAT_PLUGINS variable to include the package.

# SeAT Plugins
SEAT_PLUGINS=hermesdj/seat-buyback

After adding the plugin to your .env file run:

docker-compose up -d

The plugin should be installed after docker has finished booting.

Update

To update the plugin to the newest version you can follow the same installation steps but change the composer command to:

sudo -H -u www-data bash -c 'composer update hermesdj/seat-buyback'