Download the PHP package furic/house-ads without Composer
On this page you can find all versions of the php package furic/house-ads. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download furic/house-ads
More information about furic/house-ads
Files in furic/house-ads
Package house-ads
Short Description RESTful API serving the house ads to your client app.
License MIT
Homepage https://github.com/furic/laravel-house-ads
FAQ
Example:
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 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.
Informations about the package house-ads
laravel-house-ads
A simple house ads / cross-promo API package for Laravel 5.*.
Developed from the internal house ads system at Sweaty Chair Studio, this package serves interstitial images or videos to users, enabling cross-promotion or event ads within apps.This package includes an API to fetch ads, and a (coming soon) web console to create and manage them. The system is designed for plug-and-play use — whether you're showing ads on app launch or embedding them into your UI.
Ads are served to the client, which can decide how and when to show them — e.g., show one ad on each launch or all sequentially. Click tracking and analytics support included.
Currently, ads must be added manually to the database.
A full walkthrough is available here.
Table of Contents
- Installation
- Configuration
- Usage
- House Ads Table
- API URLs
- Unity Client Repo
- TODO
- License
Installation
Install via Composer:
If you're using Laravel 5.5 or later, that's all.
Otherwise, manually register the provider in config/app.php:
Configuration
Run migrations to create the necessary database table:
Usage
House Ads Table
| Column Name | Type | Required | Description |
|---|---|---|---|
| id | integer | ✓ | Auto-incremented ID |
| game_id | integer | ✓ | Game ID the ad promotes |
| media_portrait | varchar | Portrait image/video filename | |
| media_landscape | varchar | Landscape image/video filename | |
| open_url | tinyint | ✓ | Whether the ad opens a URL |
| url_ios | varchar | iOS redirect URL | |
| url_android | varchar | Android redirect URL | |
| repeat_count | tinyint | ✓ | How many launches to wait before repeat |
| priority | tinyint | ✓ | Priority value for sorting |
| start_at | date | ✓ | Ad start date |
| end_at | date | ✓ | Ad end date |
| confirmed_count | mediumint | ✓ | Clicked count |
| cancelled_count | mediumint | ✓ | Cancelled (failed) attempts |
| created_at | datetime | Timestamp | |
| updated_at | datetime | Timestamp |
Media files should be stored in the
/mediafolder under your Laravel root.
API URLs
-
GET
/api/house-ads
Returns all currently valid house ads as a JSON array. -
GET
/api/house-ads/{id}
Returns a specific house ad entry (for debugging). - PUT
/api/house-ads/{id}
Updates a house ad's view/click/cancel count.
Postman API documentation: View here
Unity Client Repo
A Unity integration repo is coming soon. Stay tuned!
TODO
- Build web console to create/edit ads and upload media
- Add admin authentication for the web console
- Add test coverage and factories
License
This package is open-sourced under the MIT License.
All versions of house-ads with dependencies
laravel/framework Version ~5.8||~6.0||~7.0||~8.0
furic/game-essentials Version ^1.0