Summary
=======
App that processes and displays sale, purchase and donation transactions from your web site.
Files
=====
To install on Windows 7-10 .........
WindowsREADME.txt - installation instructions
sellEbitSetup.exe - run to install
To install on Mac OS X, Linux, unix ..........
MacLinuxREADME.txt - installation instructions
RunSellEbit.zip - put into your Downloads directory and unzip there
Java8ForLinuxRel211 - a java 8 program that you can use on linux if Java version 8 is not installed
You will have to modify the Run*OnLinux.sh scripts in sellEbitData/scripts or Desktop
to use this as java
other .......
sellEbitManual.pdf - the manual
sellEbit.zip - the source code etc as an Eclipse workspace.
Description
===========
sellEbit is E-Commerce software for small businesses that use "Buy buttons" or shopping carts provided by payment gateways like PayPal or Google checkout to sell from a web site.
When a customer provides credit card details and completes a secure purchase, the gateway sends an Email to both the customer and the merchant. sellEbit processes these Emails, extracts the contents, and puts the details into a database on your computer. Any transaction as a text (xml etc) file can be processed.
When an Email / transaction arrives for a sale, sellEbit mails an acknowledgement and receipt to the customer and the sale is placed in a list which the merchant uses to track the order as it is filled. Digital data are immediately distributed e.g. eBooks, software licences.
The transaction details stored in the database can be used to:
* Display reports of income and transactions (sales, donations and purchases)
* Display histograms of transactions, products and stock levels
* Display directed graphs of relations between transactions, items, products and customers.
* Send bulk mail to customers.
* Sell software licences and digital files.
Java source code, support files, test data and documentation and a web site are supplied.
Whats it to You
===============
You can integrate sellEbit with your eCommerce software to supply sales management and analysis. You can
use notification emails from your payment gateway or output your own transaction files.
History
=======
sellEbit was originally developed to support our sales using PayPal Buy buttons on our web site.
This meant that we received an Email from PayPal for each sale.
We decided to develop some software to handle our sales, and it seemed a good idea to make the software general purpose.
We wanted to:
* record sales
* send acknowledgement emails to customers
* track sending of ordered items to customers
* keep stock levels
* be able to send promotional Emails
* produce reports of sales, customers, stock etc
* produce charts / plots of sales statistics
* distribute binary files and software licences
* support other organisations like PayPal and also transaction files
We released the software in 2009, but there was little interest so we removed if after a couple of months. The response we got was mainly from vested interests.
In August 2014 the source code was released to SourceForge. We believe it should be a useful add-on to other systems for sales on the Internet.
In May 2019 the software was resurrected as a retirement project, and the full system released including binary versions.
We put no restrictions on its use, it is completely free, although we would appreciate some acknowledgement that sellEbit software is used.
Source Code Download
====================
Everything is supplied as a the sellEbit.zip file. It contains the SellEbitWorkspace directory, which is java source etc as an eclipse workspace.
Documentation
==============
First look at the web site - SellEbitWorkspace/sellEbitWeb/index.html from which the main sellEbit web site can be accessed (its where the SourceForge web site was developed)
Then the sellEbit Manual PDF in SellEbitWorkspace/sellEbitDoco
Getting Started With Source code
================================
Use File->switch workspace to open SellEbitWorkspace in eclipse. If you use another IDE move the files as required (but eclipse will be easier).
Make copies of the standard sellEbitData and sellEbitArchive directories and call them sellEbitTest and sellEbitTestArchive. These are used for testing.
Programs are:
* SellEbitGui - the main program
* GatewayGui - defines how values are extracted from Email files
* GenEmail - generates some sample transaction files for testing
* LicenceGui - generates licence files
The workspace has been used on windows, and the run/debug configurations use the following settings (change them on other systems):
Class Params VM args
sellebit.SellEbitGui c:\sellEbit c:\sellEbitTest c:\sellEbitTestArchive -DDEBUG=TRUE -splash:c:\sellEbit\icons\sellEbit53x98.gif
gateway.GatewayGui c:\sellEbitTest c:\sellEbitTestArchive -DDEBUG=TRUE
testdata.GenEmail
licence.LicenceGui c:\sellEbitTest
Demo using Eclipse
==================
1. Run SellEbitGui for the downloaded directories. You should see some pre-loaded transactions. Use the filter tab to display lots of data.
2. clear out the system
In sellEbitTest, clear processing directories:
BadMail
error
INPUT
logs
Remove the database. Delete sellEbitDatabase directory.
Clear archive sellEbitTestArchive sub-directories
backup
done
sent
3. Run SellEbitGui. The database will be recreated.
4. Copy some (all) transactions from sellEbitTest/ALLGatewayMail into INPUT (there are other data directories)
(you should not have EMail set at this stage, so wont start emailing anyone). You can also look at the sellEbitDemoEmail directory.
5. In the control tab you should see your files queued.
click "Process Email" and apply.
Look at the log tab
6. The system is controlled by files in the config directory
e.g. edit config/configuration.txt
7. Use the transaction tab to handle your orders
You can change the item status e.g. to done, when you have sent the order.
Problems
========
Contact us on cleverco@users.sourceforge.net if you have problems with the download. If I am away I might not reply for a while.
