Package Data | |
---|---|
Maintainer Username: | kongnir |
Maintainer Contact: | support@redooor.com (Redooor LLP) |
Package Create Date: | 2014-07-31 |
Package Last Update: | 2024-12-16 |
Home Page: | |
Language: | PHP |
License: | MIT |
Last Refreshed: | 2025-01-13 15:07:09 |
Package Statistics | |
---|---|
Total Downloads: | 596 |
Monthly Downloads: | 0 |
Daily Downloads: | 0 |
Total Stars: | 43 |
Total Watchers: | 9 |
Total Forks: | 16 |
Total Open Issues: | 14 |
A Laravel 5 package as a backend administrating tool for Content Management and Ecommerce sites. Gives you ability to add, edit and remove category, product, promotions and many more. Provides User Interface for administrating users and groups.
RedminPortal currently supports both Laravel 5.0 and 5.1. See Compatibility.
#Compatibility
| Laravel | RedminPortal | Branch | |:-------:|:------------:|:------:| | 4.2 | 0.1.x | v0.1 | | 5.0 | 0.2.x | v0.2 | | 5.1 | 0.3.x | v0.3 |
Version 0.2 and 0.3 are developed in parallel. The only difference between them is the Laravel version they support. However, this may change in future.
Development for branch v0.1 has stopped. Please upgrade to v0.2 or v0.3 instead.
Version >=0.3.2 and >=0.2.2 may break your front-end due to the change in UserPricelist. Refer to UPGRADE.md for the upgrading instructions.
Version 0.3 is backward compatible to Version 0.2.
Version 0.3 and 0.2 are SOMEWHAT backward compatible to Version 0.1. Refer to UPGRADE.md.
Upgrading from v0.1?
We've included a few database migrations to upgrade the database to support v0.2/v0.3. However, use this at your own risk. The upgrade scripts were not thoroughly tested and it may not be complete. If you find something missing, please report to us using the issue ticket. We welcome any contribution too.
Refer to UPGRADE.md for the upgrading instructions.
There is an translation option in Category, Module, Media, Product, Promotion and Portfolio.
You can add more languages in the translation config file at path
vendor\redooor\redminportal\src\config\translation.php
or if you have published it to your root
root\config\packages\redooor\redminportal\translation.php
To use it, get the model's translations and use json_decode to convert content into an object, like this:
foreach ($product->translations as $translation) {
$lang = $translation->lang;
$translated = json_decode($translation->content);
var_dump($translated->name, $translated->short_description, $translated->long_description);
}
You can install Laravel version 5.1 using the command:
composer create-project laravel/laravel myproject 5.1.*
Add Redminportal to composer.json of a new Laravel application, under "require". Like this:
"require": {
"laravel/framework": "5.1.*",
"redooor/redminportal": "0.3.[*|specify a version]"
},
NOTE:
It is advisable to specify the minor version (e.g. 0.3.3) so that it's more controlled. Although we try to be as backward compatible as possible, many changes are added into each version, so it may sometimes break your front end code.
Then run php composer update [--prefer-dist]
in a terminal.
Use --prefer-dist
to include only essential files (i.e. exclude tests).
Now, edit your [root]\config\app.php providers and alias array like this:
'providers' => array(
Illuminate\Foundation\Providers\ArtisanServiceProvider::class,
... omitted ...
// Add this line
Redooor\Redminportal\RedminportalServiceProvider::class,
),
Then run php composer dump-autoload
in a terminal.
Run the following commands in a terminal to perform database migration for Redminportal:
?> php artisan vendor:publish --provider="Redooor\Redminportal\RedminportalServiceProvider" --tag="migrations" [--force]
?> php artisan migrate --path=/database/migrations/vendor/redooor/redminportal
CAUTION: using --force will overwrite existing files
Run the following in a terminal to seed the database with initial admin username and password:
?> php artisan db:seed --class="RedminSeeder"
Username/password: admin@admin.com/admin
Publish package assets by running this in a terminal:
?> php artisan vendor:publish --provider="Redooor\Redminportal\RedminportalServiceProvider" --tag="public" [--force]
CAUTION: using --force will overwrite existing files
Publish package config by running this in a terminal:
?> php artisan vendor:publish --provider="Redooor\Redminportal\RedminportalServiceProvider" --tag="config" [--force]
CAUTION: using --force will overwrite existing files
Optional: Publish package views by running this in a terminal:
Only do this if you want to modify Redminportal views without editing the source code.
?> php artisan vendor:publish --provider="Redooor\Redminportal\RedminportalServiceProvider" --tag="views" [--force]
CAUTION: using --force will overwrite existing files
It is recommended that contributors use Laravel Homestead for development because it will provide the same development environment for all of us. Read more about Laravel Homestead here.
You can install Laravel version 5.1 using the command:
composer create-project laravel/laravel myproject 5.1.*
Create a folder named "packages" inside the [root] folder.
Clone the Redooor\Redminportal repository into [root]\packages\redooor\redminportal folder.
Open a terminal, cd to [root]\packages\redooor\redminportal folder then run:
composer update --prefer-dist -vvv --profile
Then add Redooor\Redminportal source to [root]'s composer.json under "autoload" like this:
"autoload": {
"classmap": [
"database"
],
"psr-4": {
"App\\": "app/",
"Redooor\\Redminportal\\": "packages/redooor/redminportal/src"
}
},
Then cd to [root]'s folder and run:
composer update --prefer-dist -vvv --profile --no-dev
NOTE: the [root]'s phpunit dependency will clash with the package's phpunit. "--no-dev
" ensures that it is not installed on [root]. You can also choose to remove phpunit from require
inside the [root]'s composer.json.
Now, edit your [root]\config\app.php providers and alias array like this:
'providers' => array(
Illuminate\Foundation\Providers\ArtisanServiceProvider::class,
... omitted ...
// Add this line
Redooor\Redminportal\RedminportalServiceProvider::class,
),
Run the following commands in a terminal to perform database migration for Redminportal inside the [root] folder:
?> php artisan vendor:publish --provider="Redooor\Redminportal\RedminportalServiceProvider" --tag="migrations" [--force]
?> php artisan migrate --path=/database/migrations/vendor/redooor/redminportal
CAUTION: using --force will overwrite existing files
Run the following in a terminal to seed the database with initial admin username and password:
?> php artisan db:seed --class="RedminSeeder"
Username/password: admin@admin.com/admin
Publish package assets by running this in a terminal:
?> php artisan vendor:publish --provider="Redooor\Redminportal\RedminportalServiceProvider" --tag="public" [--force]
CAUTION: using --force will overwrite existing files
Publish package config by running this in a terminal:
?> php artisan vendor:publish --provider="Redooor\Redminportal\RedminportalServiceProvider" --tag="config" [--force]
CAUTION: using --force will overwrite existing files
Optional: Publish package views by running this in a terminal:
Only do this if you want to modify Redminportal views without editing the source code.
?> php artisan vendor:publish --provider="Redooor\Redminportal\RedminportalServiceProvider" --tag="views" [--force]
CAUTION: using --force will overwrite existing files
In packages\redooor\redminportal folder, run
?> composer update --prefer-dist -vvv --profile
?> vendor/bin/phpunit
NOTE: If you run out of memory while running the full tests, try running the tests by sub-folders.
?> vendor/bin/phpunit tests/models/
?> vendor/bin/phpunit tests/controllers/
?> vendor/bin/phpunit tests/relationships/
For transparency into our release cycle and in striving to maintain backward compatibility, Redooor RedminPortal will adhere to the Semantic Versioning guidelines whenever possible.
Thank you for considering contributing to RedminPortal. Before any submission, please spend some time reading through the CONTRIBUTING.md document.
Andrews Ang
RedminPortal is open-sourced software licensed under the MIT license.
Refer to CHANGELOG.md
Refer to UPGRADE.md