Documentation in https://dandisy.github.io, (*1)
1. Webcore
Installation
Copy, paste and hit the Enter key in console line by line, (*2)
Make sure your server, create "webcore" database, edit .env using your favorite editor,
for example using nano editor, run this in console, (*4)
sudo nano .env
then, (*5)
php artisan key:generate
then, (*7)
php artisan migrate --seed
php artisan storage:link
now get it all on your favorite browser, (*8)
http://localhost/webcore/public
and
http://localhost/webcore/public/admin
The default users are, (*9)
- superadminstrator@app.com
- administrator@app.com
- user@app.com
with default password is password
--OPTIONAL--, (*10)
if you want to activate oauth,, (*11)
edit the uri oauth in vue files in resources/assets/js/components/passport, (*12)
php artisan passport:keys
npm install
npm run dev
then you can access oauth admin panel
to manage your oauth client in, (*13)
http://localhost/webcore/public/oauth-admin
Usage
- As an Admin Panel (with no public site in frontend)
run these artisan commands in your console
if you have schema model file, change YourModel to the name of model to be generate, (*14)
php artisan generate:api_scaffold YourModel --fieldsFile=YourModel.json --datatables=true
or if you want to specify field interactively in console, (*15)
php artisan generate:api_scaffold YourModel --datatables=true
Concept
Admin Page - UI Component - Front Page
-
Backend Page (Admin), (*16)
Scope of Admin Page :
provide content management, presentation management, asset management and configuration, (*17)
-
UI Component (just a part of page), (*18)
Scope of UI Component (widget) :
provide reusable part of UI (widget) to be used in template of page (with layout positions),
(*and provide tracking of user interaction for personalization), (*19)
Scope of Page :
layouting and styling UI Component globaly as a Page by incorporating a template, (*20)
-
Frontend Page, (*21)
Scope of Front Page :
provide User Experience with content personalization, (*22)
run these artisan commands in your console
php artisan generate:api_scaffold Page --fieldsFile=Page.json --datatables=true --prefix=admin --logs
php artisan generate:api_scaffold Post --fieldsFile=Post.json --datatables=true --prefix=admin --logs
then run, (*23)
composer require dandisy/webcore-page:dev-master
php artisan vendor:publish --provider="Webcore\Page\PageServiceProvider" --tag=config
if you want Webcore Front Page System themes & components sample code, (*24)
download it in https://github.com/dandisy/themes (please don't clone!), (*25)
then extract to your project root directory, (*26)
see https://github.com/dandisy/webcore-page for more info, (*27)
then, (*28)
composer require dandisy/webcore-menu:dev-master
php artisan vendor:publish --provider="Harimayco\Menu\MenuServiceProvider"
php artisan vendor:publish --provider="Webcore\Menu\MenuServiceProvider" --tag=models
php artisan migrate
see https://github.com/dandisy/webcore-menu for more info, (*29)
for tidiness, you can arrange Admin Page side menu in resources/views/layouts/menu.blade.php, (*30)
Ready to Use
If you still confused with above usage instruction you can explore your self and try to install ready to use webcore sample as website cms, (*31)
download it in https://github.com/dandisy/webcore-sample, (*32)
or for better user experience CMS structure, with https://github.com/dandisy/elogui or https://github.com/dandisy/webcore-presentation, (*33)
download it in https://github.com/dandisy/webcore-cms, (*34)
Features
-
Admin Template, (*35)
, (*36)
-
File Manager, (*37)
, (*38)
-
Menu Manager, (*39)
, (*40)
-
Image Manipulation, (*41)
to manipulate the image use, (*42)
http://localhost/webcore/public/img/{path}?{param=value}
default {path} is configured relative to public_path, see .env for FILESYSTEM_DRIVER and config/filesystems.php, (*43)
refer to the Glide documentation in http://glide.thephpleague.com for manual guide, (*44)
-
Laravel Generator based on http://labs.infyom.com/laravelgenerator with Additional features, (*45)
- Date Time Picker (htmltype = date-picker, time-picker or datetime-picker)
- Select2 (all select input will be select2, for multiple use htmltype = multi-select)
- Two side Multiple Select (htmltype = two-side-select)
- HTML Text Editor (htmltype = text-editor)
- File Manager (htmltype = file-manager or files-manager)
- Nullable field in migration (console option = n, or in json schema file using dbNullable = true)
- Log fields : created_by and updated_by (artisan command option = --logs)
- Related Dropdown (in console, use --relations option) : add view model in controller, and relational input form in view (htmltype = select,relation:{view-model}={field-to-show}={field-as-value})
- Related Form (in console, use --relations option) : add view model in controller, and relational input form in view (dbtype = table and htmltype = related-form,related-field1,related-field2,related-field3,...)
- Component and theme directory reader generator (htmltype = select,component or select,theme)
- Model directory reader generator (htmltype = select,model)
refer to the sample model schema files in resources/model_schemas, (*46)
-
Front Page System (support themes, template position and view components), (*47)
Sample code can be download in https://github.com/dandisy/themes, (*48)
-
Reusable Component, (*49)
-
Using Webcore Component Presentation System for Font Page Component, (*50)
Code Sample can be download in https://github.com/dandisy/themes, (*51)
-
Using Widget (Widget Class & Widget View) using arrilot/laravel-widgets for UI Component, (*52)
as much as possible the widget should have a loose coupled, bring data on the fly, avoid directly include / use in widget class, (*53)
webcore include a widget, with this you able to use shortcode on Page description field
to get datasource from models, use syntax :
[source=ModelName,where=some_field_name:value,position:some_theme_position,widget=some_widget_view], (*54)
-
Using Laravel Package, (*55)
webcore include dandisy/elorest package at package/webcore folder which can be used as an example, (*56)
-
Pre Configured Oauth using Laravel Passport, (*57)
with Elorest as a Laravel eloquent RESTAPI package, refer to https://github.com/dandisy/elorest, (*58)
-
to login (password grant) use http://localhost/webcore/public/oauth/token, (*59)
with params :
- client_id
- client_secret
- grant_type
- username
- password
- scope
-
to get resources example http://localhost/webcore/public/api/product, (*60)
with header Authorization = Bearer {your-token}
-
EloREST, (*61)
REST API using the Laravel's Eloquest Syntax (methods & params), (*62)
Example API queries :, (*63)
https://your-domain-name/api/elorest/Models/Post?leftJoin=comments,posts.id,comments.post_id&whereIn=category_id,[2,4,5]&select=*&get=
https://your-domain-name/api/elorest/Models/Post?join[]=authors,posts.id,authors.author_id&join[]=comments,posts.id,comments.post_id&whereIn=category_id,[2,4,5]&select=posts.*,authors.name as author_name,comments.title as comment_title&get=
https://your-domain-name/api/elorest/Models/Post?&with=author,comment&get=*
https://your-domain-name/api/elorest/Models/Post?&with=author(where=name,like,%dandisy%),comment&get=*
multi first nested closure deep
https://your-domain-name/api/elorest/Models/Post?&with=author(where=name,like,%dandisy%)(where=nick,like,%dandisy%),comment&get=*
second nested closure deep
https://your-domain-name/api/elorest/Models/Post?&with=author(with=city(where=name,like,%jakarta%)),comment&get=*
https://your-domain-name/api/elorest/Models/Post?&with[]=author(where=name,like,%dandisy%)&with[]=comment(where=title,like,%test%)&get=*
https://your-domain-name/api/elorest/Models/Post?paginate=10&page=1
Dependency
* dandisy/adminlte-templates based on infyomlabs/adminlte-templates
* dandisy/laravel-generator based on infyomlabs/laravel-generator
* dandisy/swagger-generator based on infyomlabs/swagger-generator
* dandisy/filemanager based on infinety-es/filemanager
* dandisy/webcore-page
* dandisy/webcore-menu
* arrilot/laravel-widgets
* barryvdh/laravel-debugbar
* league/glide-laravel
* santigarcor/laratrust
* harimayco/laravel-menu
* atayahmet/laravel-nestable
* ixudra/curl or guzzlehttp/guzzle
If you use laravel passport :
* spatie/laravel-cors
* barryvdh/laravel-dompdf or seguce92/laravel-dompdf
* phpoffice/phpspreadsheet or maatwebsite/excel
* pragmarx/tracker or jeremykenedy/laravel-logger
* spatie/laravel-activitylog
* fireguard/report or jimmyjs/laravel-report-generator
* khill/lavacharts or consoletvs/charts
//--------------------------------------------#, (*64)
More Screenshots
Webcore CMS using https://github.com/dandisy/elogui or https://github.com/dandisy/webcore-presentation, (*65)
Download Webcore CMS in https://github.com/dandisy/webcore-cms, (*66)
, (*67)
, (*68)
, (*69)
, (*70)
, (*71)
//---------------------------------------------#, (*72)
2. Laravel Generator
Webcore use infyomlabs/laravel-generator, by changing the artisan command to be
more generic :, (*73)
php artisan generate[.command]:{command} {Model_name} [option]
Refer to the infyomlabs/laravel-generator documentation here http://labs.infyom.com/laravelgenerator, (*74)
Perspective :
HUMAN
Interface - Tools (Worker) - Executor
Commands\* - Common\*, Utils\* and helper - Generators\*
COMPUTER
Interface - Tools (Worker) - Executor
Generators\* - Common\*, Utils\* and helper - Commands\*
Guidance
-
To add additional HTML type definition, add and edit these :, (*75)
- add stub file in adminlte-templates\templates\scaffold\fields
- add stub file in adminlte-templates\templates\vuejs\fields
-
edit Utils\HTMLFieldGenerator, (*76)
-
edit Generators\ViewGenerator, (*77)
- edit Generators\VueJs\ViewGenerator
-
To add additional command, command option, or fields option, (*78)
- edit or add Common\*
- edit or add Commands\* (BaseCommand, etc)
Note
-
Commands\* :, (*79)
use Common\CommandData,
use Utils\FileUtil,
use Generator\*, (*80)
base Commands\BaseCommand, (*81)
- parsing console command
- initializing commandData
- execute Generators\* to generating files and migrating database table
-
Utils\GeneratorFieldsInputUtil :, (*82)
use Common\GeneratorField, (*83)
- get fields specification from console command
- return field specification by utilizing Common\GeneratorField
-
Utils\HTMLFieldGenerator :, (*84)
use Common\GeneratorField, (*85)
- return fieldTemplate will be used
-
Common\GeneratorField :, (*86)
- parsing parts of fields specification (db type, html input, option)
- preparing migration
-
Common\GeneratorConfig :, (*87)
- load, init and set config
- get console command option
-
Common\CommandData :, (*88)
use Utils\GeneratorFieldsInputUtil,
use Utils\TableFieldsGenerator, (*89)
- get and set commandData from config, file, and console
-
Generators\* :, (*90)
use Utils\FileUtil,
use Common\CommandData,
use Utils\HTMLFieldGenerator in Generators\Scaffold\ViewGenerator, (*91)
base Generators\BaseGenerator, (*92)
- define generator functionality with data and template parameters to be used
- define rollback
//--------------------------------------------#, (*93)
3. Roadmap
Versions, (*94)
1.0.0 Single Platform
1.1.0 Easy Platform
1.2.0 In Context Platform
1.3.0 Experience Platform
1.4.0 Enterprise Platform
1.5.0 Digital Solution
#
by dandi@sgdigitals.com, (*95)
Wallogit.com
