shaygan/affiliate-bundle

A simple Symfony Affiliate Bundle.

Tuesday, November 28, 2017
by imangh
Repository
1 Watchers
7 Stars
135 Installations

PHP
0 Dependents
0 Suggesters
1 Forks
0 Open issues
6 Versions
6 % Grown

The README.md

ShayganAffiliateBundle

A simple Symfony Affiliate Bundle., _(*1)

This ~~FOSUserBundle compatible~~ Bundle tracks referrals with query string parameter and detect referred registrations via cookie. You can easil ask the bundle for commission amount (if there is any referrer) and apply the amount to referrer's user account., _(*2)

Your Order Object needs to implements \Shaygan\AffiliateBundle\Model\OrderInterface., _(*3)

Install

Via Composer, _(*4)

``` bash $ composer require shaygan/affiliate-bundle, _(*5)


Edit your app/AppKernel.php to register the bundle in the registerBundles() method as above:


```php
class AppKernel extends Kernel
{

    public function registerBundles()
    {
        $bundles = array(
            // ...
            // register the bundle here
            new \Shaygan\AffiliateBundle\ShayganAffiliateBundle()
        );
    }
}

Configure the bundle

This bundle was designed to just work out of the box. The only thing you have to configure in order to get this bundle up and running is your commission type amount and count., _(*6)

# app/config/config.yml

shaygan_affiliate:
    programs:
        membership_upgrade:
            type: fixed-amount
            first_commission_amount: 3
            commission_amount: 1
            max_count: 10
        purchase:
            type: percentage
            first_commission_percent: 15
            commission_percent: 10
            max_count: 10

By default it look for ?ref=REFERRER_ID in URLs the ref is configurable, _(*7)

Usage

ShayganAffiliateBundel tracks FOSUserBundle registrations automatically and after every purchase you just need to ask the bundle for the commission payment if the referrer eligible for commission the bundle with return a commission Entity that contain the amount you have to pay to the referrer, othervise returns null., _(*8)

  // ... 
  // MyOrder SHOULD implements \Shaygan\AffiliateBundle\Model\OrderInterface
  $order = new \AppBundle\Entity\MyOrder();
  $order->setOwnerUser($this->getUser());

  $em = $this->getDoctrine()->getManager();
  $em->persist($order);
  $em->flush();
  $affiliate = $this->get("shaygan_affiliate");
  $commission = $affiliate->getPurchaseCommission($order);
  if(null !== $commission){
    $commissionAmount = $commission->getCommissionAmount();
    $referrer = $commission->getReferrer();
    $referrerUserId = $referrer->getId();
    // You can apply the commission amount to the accont of referrer User here
    // ...
  }
  //...

Testing

Not implemented yet, _(*9)

License

The MIT License (MIT). Please see License File for more information., _(*10)

php symfony2 bundle symfony3 affiliate affiliate-bundle

15/11 2017

v0.1.0

0.1.0.0 http://i-gh.ir

A simple Symfony Affiliate Bundle.

Sources Download

MIT

The Requires

by Iman Ghasrfakhri

php symfony2 bundle symfony3 affiliate affiliate-bundle

symfony-bundle affiliate-bundle

A simple Symfony Affiliate Bundle.