Local Dynamizer Admin Panel

This panel (only in Spanish atm) tries to help community managers to manage their clients' social networks. For now it's a proof of concept with sections to import resources that can serve them, an agenda to keep appointments and a database with clients (here called stores).

• Site under development at: https://dinamizadorlocal.com (Ask me for a user if you want to test it).

• ⏰ Estimated hours of work so far: 143 hours.

• More screenshots on screenshots directory.

Prerequisites

• Modify on php.ini date.timezone = "Europe/Madrid"

Install

git clone https://github.com/jmcerrejon/localdynamizer.git
composer update && npm install
cp .env.example .env # Add your MySQL config
php artisan key:generate
php artisan migrate --seed
php artisan storage:link # If you have a /public_html dir, skip this command and check the next section
composer dump-autoload

Storage link in /public_html

Maybe your hosting has a public_html directory, so we can't use public. Don't worry, try the next:

ln -s $PWD/storage/app/public/ $PWD/public_html/storage
sudo chmod -R 775 storage

403 issues

It's a knighmare. Some tips:

chown -R $USER:$(id -gn $USER) storage
chown -h $USER:$(id -gn $USER) storage
find * -type d -exec chmod 755 {} \;
find * -type f -exec chmod 644 {} \;

On production environment an extra step maybe is required:

Install packages:

sudo apt install -y php7.4-zip php-xml php7.4-gd

Change time-zone (Debian):

timedatectl set-timezone "Europe/Madrid"
timedatectl | grep "Time"
timedatectl  status

Now:

npm run production
php artisan config:cache # Run this when update files inside /config

Development

• You can use http://yourdomain.test/auto-login to skip login form and go directly to home.

Interesting Packages and Libraries used

Check composer.json for more pkgs.

• https://flickity.metafizzy.co/

• https://sean.is/poppin/tags

• https://github.com/michalsnik/aos/tree/v2

• https://github.com/spatie/laravel-searchable

• https://github.com/fiduswriter/Simple-DataTables

• https://docs.laravel-excel.com/3.1/getting-started/

• https://unisharp.github.io/laravel-filemanager/

• https://github.com/DarkaOnLine/L5-Swagger (Help me a lot this post on Medium)

• https://github.com/enlightn/enlightn

API Documentation

Formerly called Swagger (quite often called this even now), OpenAPI is a standard of documenting APIs. Its specification is available on Github here.

The OpenAPI Specification is a broadly adopted industry standard for describing modern APIs.

URL: https://dinamizadorlocal.com/api/docs

Generate: npm run generate-documentation

Credits

👨🏻‍💻 Jose Manuel Cerrejon Gonzalez

✉️ [email protected]

📍 Huelva, Spain

Dev with ♥️ using Laravel, AdminLTE for panel and landing/Admin panel with Tailwind CSS.

Licence

Commercial license

If you want use this panel in commercial products, projects, and applications, the Commercial license is the appropriate license. With this option, your source code is kept proprietary. To purchase a commercial license you need to buy a licence from the owner. Contact for licence

Open-source license

Free just for educational and non-commercial purpose.