Skip to content
chaseoes edited this page Aug 22, 2012 · 7 revisions
  1. Copy the web folder included in the download to your website and copy the plugin's .jar to your plugins folder. Restart or reload your server.
  2. Make a new MySQL database and enter your database details in the config.php included in the web folder, and the config.yml created by the plugin.
  3. Log into PayPal, go to My Account > My Selling Tools > Instant Payment Notifications and enter the URL to where you uploaded the ipn.php file included in the web folder.
  4. Add this example line to your existing/new PayPal buttons to allow players to enter their username: <input type="text" name="custom" value="Enter your Minecraft username here!"><br /><br />

If you need help with any of those steps just scroll down for a more detailed explanation on them.


Step 1 - MySQL Database Creation

Before you install this plugin, you will need to set up a MySQL database. One is required to use the plugin. If you are using a dedicated Minecraft host, contact them about getting one. Otherwise, here's some good tutorials on how to set one up:

http://www.youtube.com/watch?v=FfZhLr5HohQ

Make sure you remember the details for the datbase, you will need them in later steps.

Step 2 - Installing Web Files

Copy the "web" folder included in the Donator.zip you downloaded to your webserver using FTP. It is recommended you change the name of this folder for security purposes. Your host must support PHP! Also, for security purposes, you might want to rename the "web" folder to something different. Do not change the names of the files inside it.

Using a text editor such as Notepad++, open the config.php file. Fill in the necessary database details. The formatting of this file is important, don't erase any "'s etc., or you will run into problems. You may leave the other settings alone, only change them if you know what you're doing.

Step 3 - Installing & Configuring The Plugin

Copy the Donator.jar file included in the Donator.zip file you downloaded into the /plugins/ directory on your server. Start your server.

A config.yml file will have been automatically made in the /plugins/Donator/ directory, open it with a text editor such as Notepad++ and enter your database details.

This is also where you configure your packages. For more configuration related help, visit this page.

Step 4 - Getting The Plugin To Work With PayPal

Profile > My Selling Tools > Instant Payment Notifications

On the My Selling Tools page, look for "Instant payment notifications" (under "Getting paid and managing my risk"), and click "Update".

Click the yellow "Edit Settings" button and enter the URL to the pp.php file you uploaded earlier (included in the 'web' folder). E.g. http://example.com/web/ipn.php. Check "Receive IPN messages" then click save.

Step 5 - Add Donate Buttons To Your Website

To create buttons in PayPal, click on the "Merchant Services" tab then "Create payment buttons for your website".

Copy the HTML code provided into your webpage, and you'll need to add one line that lets the user input their username BELOW the very first line in the HTML code provided: <input type="text" size="60" name="custom" value="Enter your Minecraft username here!"><br /><br />

You may change the "Enter your Minecraft username here!" text and anything else if you know HTML, but the name="custom" must stay for the plugin to work. You can add that line to existing buttons and it will work fine. This is also just an example, and you should also look into adding validation, such as limiting the amount of characters they can enter to 20, and minimum to 2.

All done! You successfully set up your website to work with Donator.

Clone this wiki locally