Download the PHP package zgabievi/laravel-promocodes without Composer

On this page you can find all versions of the php package zgabievi/laravel-promocodes. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package laravel-promocodes

#StandWithUkraine laravel-promocodes

laravel-promocodes

Packagist Packagist license

Coupons and promotional codes generator for Laravel. Current release is only for Laravel 9.x and PHP 8.1. It's completely rewritten, and if you are using previous version, you should change your code accordingly. Code is simplified now and it should take you several minutes to completely rewrite usage.

Attention: Current version is completely rewritten. If you are missing some functionality, that was possible to achieve in previous versions, fill free to open issue. Hope this new version will be easier to use, and it will provide better functionality for your needs.

Installation

You can install the package via composer:

Configuration

Now you can change configurations as you need:

After you configure this file, run migrations:

Now you will need to use AppliesPromocode on your user model.

Usage

It's very easy to use. Methods are combined, so that you can configure promocodes easily.

Reference

Name Explanation
Mask Astrisks will be replaced with random symbol
Characters Allowed symbols to use in mask replacement
Multi use Define if single code can be used multiple times, by the same user
Unlimited Generated code will have unlimited usages
Bound to user Define if promocode can be used only one user, if user is not assigned initially, first user will be bound to promocode
User Define user who will be initially bound to promocode
Count Amount of unique promocodes should be generated
Usages Define how many times can promocode be used
Expiration DateTime when promocode should be expired. Null means that promocode will never expire
Details Array of details which will be retrieved upon apply

Creating Promocodes

Using class

Combine methods as you need. You can skip any method that you don't need, most of them already have default values.

Using helper

There is a global helper function which will do the same as promocodes class. You can use named arguments magic from php 8.1.

Using command

There is also the command for creating promocodes. Parameters are optional here too.

Generating Promocodes

If you want to output promocodes and not save them to database, you can call generate method instead of create.

Applying Promocode

Using class

Combine methods as you need. You can skip any method that you don't need.

Using helper

There is a global helper function which will do the same as promocodes class.

Using command

There is also the command for applying promocode.

Exceptions

While trying to apply promocode, you should be aware of exceptions. Most part of the code throws exceptions, when there is a problem:

Events

There are two events which are fired upon applying.

Expiring Promocode

Using helper

There is a global helper function which will expire promocode.

Using command

There is also the command for expiring promocode.

Trait Methods

If you added AppliesPromocode trait to your user model, you will have some additional methods on user.

Additional Methods

Testing

Contributing

Please see CONTRIBUTING for details.

Credits

License

The MIT License (MIT). Please see License File for more information.


All versions of laravel-promocodes with dependencies

PHP Build Version
Package Version
Requires php Version ^8.1
illuminate/support Version ^9.0
illuminate/console Version ^9.0
illuminate/database Version ^9.0
illuminate/broadcasting Version ^9.0
illuminate/queue Version ^9.0
illuminate/container Version ^9.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package zgabievi/laravel-promocodes contains the following files

Loading the files please wait ....