h4zz4rddev/seat-buyback

Buyback plugin for SeAT

1.3.4 2023-12-05 21:25 UTC

README

Latest Stable Version

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

In case of problems please contact me via EVE-Online message or over the seat discord: H4zz4rd

Screenshots

adminpanel

requestpanel

contracts

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:

discordexample

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 h4zz4rddev/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=h4zz4rddev/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 h4zz4rddev/seat-buyback'

Donations

Donations are always welcome, although not required. If you end up using this module a lot, I'd appreciate a donation. You can give ISK or contract PLEX and Ships to H4zz4rd.