pimcore / demo

The Official Pimcore Demo Package - You're new to Pimcore? That's your entry point! 🤓
Other
101 stars 106 forks source link

Demo and Blue Print Application for Pimcore

This demo package is intended to be used by Pimcore newcomers who want to learn Pimcore and see it in action. It's tailored get an overview of Pimcores CMS, DAM, PIM and E-Commerce functionality and can be used as a blue print for E-Commerce Applications built with Pimcore. If you are an experienced Pimcore developer, have a look at the Skeleton linked below instead.

Getting started

COMPOSER_MEMORY_LIMIT=-1 composer create-project --no-scripts pimcore/demo my-project
cd ./my-project
./bin/console assets:install --symlink --relative
./vendor/bin/pimcore-install
./bin/console cache:clear

Docker

You can also use Docker to setup a new Pimcore Installation. You don't need to have a PHP environment with composer installed.

Prerequisits

Follow these steps

  1. Initialize the demo project using the pimcore/pimcore image docker run -u `id -u`:`id -g` --rm -v `pwd`:/var/www/html pimcore/pimcore:php8.3-latest composer create-project --no-scripts pimcore/demo my-project
  2. Go to your new project cd my-project/
  3. Part of the new project is a docker compose file
    • Run echo `id -u`:`id -g` to retrieve your local user and group id
    • Open the docker-compose.yaml file in an editor, uncomment all the user: '1000:1000' lines and update the ids if necessary
    • Start the needed services with docker compose up -d
    • Install the assets by running the script docker compose exec php bin/console assets:install --symlink --relative
  4. Install pimcore and initialize the DB docker compose exec php vendor/bin/pimcore-install --mysql-host-socket=db --mysql-username=pimcore --mysql-password=pimcore --mysql-database=pimcore
    • When asked for admin user and password: Choose freely
    • This can take a while, up to 20 minutes
  5. Clear and warm up the cache with docker compose exec php bin/console cache:clear
  6. :heavy_check_mark: DONE - You can now visit your pimcore-demo:

Pimcore Platform Version

By default, Pimcore Platform Version is added as a dependency which ensures installation of compatible and in combination with each other tested versions of additional Pimcore modules. More information about the Platform Version can be found in the Platform Version docs.

It might be necessary to update a specific Pimcore module to a version that is not included in the Platform Version. In that case, you need to remove the platform-version dependency from your composer.json and update the module to the desired version. Be aware that this might lead to a theoretically compatible but untested combination of Pimcore modules.

Other demo/skeleton packages