Skip to content
Contao Open Source CMS
PHP JavaScript CSS HTML
Branch: master
Clone or download

Latest commit

aschempp Always use the regular icon if page type has no icon (see #1650)
Description
-----------

Preparing for #1516: I very much doubt every developer wants to provide a custom icon for a custom page type.

Currently, extensions (most likely) copy their images into the core's theme folder (e.g. [folderpage](https://github.com/terminal42/contao-folderpage) does that). But that shouldn't be used, people should use the hook to override the icon and provide their own path.

Commits
-------

a1c2837 Always use the regular icon if page type has no icon
Latest commit e7e0054 May 18, 2020

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Merge branch '4.9' May 14, 2020
calendar-bundle Merge branch '4.9' May 14, 2020
comments-bundle Merge branch '4.9' May 14, 2020
core-bundle Always use the regular icon if page type has no icon (see #1650) May 18, 2020
faq-bundle Merge branch '4.9' May 14, 2020
installation-bundle Merge branch '4.9' May 14, 2020
listing-bundle Merge branch '4.9' May 14, 2020
manager-bundle Merge branch '4.9' May 14, 2020
news-bundle Merge branch '4.9' May 14, 2020
newsletter-bundle Merge branch '4.9' May 14, 2020
.editorconfig Merge the .editorconfig files Aug 15, 2018
.gitattributes Use GitHub actions for CI (see #1304) Feb 10, 2020
.gitignore Use GitHub actions for CI (see #1304) Feb 10, 2020
.yamllint Upgrade yamllint and adjust the YAML files (see #1602) Mar 31, 2020
CHANGELOG.md Update the meta data Jan 18, 2020
CONTRIBUTORS.md Fix some minor issues Sep 25, 2019
DEPRECATED.md Correct the left-over references to app/Resources/contao Jul 8, 2019
LICENSE Merge the other meta files Aug 16, 2018
LIMITATIONS.md Add a known limitation for importing style sheets with media query (see Jan 22, 2019
README.md Merge branch '4.9' Apr 2, 2020
UPGRADE.md Add removal of user agent body class to UPGRADE.md (see #941) Dec 13, 2019
VERSIONING.md Merge the other meta files Aug 16, 2018
codecov.yml Use GitHub actions for CI (see #1304) Feb 10, 2020
composer.json Merge branch '4.9' May 14, 2020
gulpfile.js Fix the gulp watch task and the TinyMCE templates Jun 7, 2019
monorepo.yml Merge branch '4.9' May 14, 2020
package-lock.json Add z-index:1 to the paste hint (see #1284) Feb 4, 2020
package.json Fix the search focus outline in Safari (see #1113) Dec 18, 2019
phpstan.neon.dist Merge branch '4.9' May 14, 2020
phpunit.xml.dist Move the static analysis to the "checks" workflow (see #977) Nov 14, 2019
psalm.xml Use psalm/plugin-symfony instead of seferov/symfony-psalm-plugin (see #… Apr 9, 2020

README.md

GitHub Codecov Packagist

About

Contao is a powerful open source CMS that allows you to create professional websites and scalable web applications. Visit the project website for more information.

Purpose

The purpose of this package is to develop the Contao bundles. Use it if you e.g. want to create a pull request or if you want to report an issue.

The monorepo is split into separate packages automatically:

Please do not use contao/contao in production! Use the split packages instead.

Development

To create a pull request and to test your changes within a running Contao application, it is the easiest to use the Contao Managed Edition. Start by installing it in your current directory:

composer create-project --no-install contao/managed-edition <directory> <branch>

Replace <directory> with the directory you want to install the Managed Edition in (use . for the current one). Replace <branch> with dev-master if you want to add a new feature or with <lts-version>.x-dev (currently 4.4.x-dev and 4.9.x-dev) if you want to fix a bug.

Then adjust the require section in your composer.json file so Composer loads the monorepo instead of the individual bundles:

"require": {
    "php": "^7.2",
    "contao/contao": "dev-master"
},

Again, use dev-master if you want to add a new feature or <lts-version>.x-dev if you want to fix a bug.

Next, install the dependencies:

composer update

Composer will automatically clone the Git repo into the vendor/contao/contao folder. You can finish your setup by opening https://your-domain.local/contao/install in your browser.

All the changes you make in vendor/contao/contao are be tracked via Git, so you can submit your pull request directly from within your application.

Running scripts

You can use Composer to run the code quality scripts:

composer run all
composer run unit-tests
composer run cs-fixer
composer run phpstan
composer run psalm

If you want to pass additional flags to the underlying commands, you can use the -- argument:

composer run unit-tests -- --filter CoreBundle
composer run cs-fixer -- --clear-cache

Functional tests

To set up functional tests, create a database named contao_test and import the core-bundle/tests/Functional/app/Resources/contao_test.sql file.

mysql -e "CREATE DATABASE contao_test"
mysql contao_test < core-bundle/tests/Functional/app/Resources/contao_test.sql

If your database uses credentials, copy the file core-bundle/phpunit.xml.dist to core-bundle/phpunit.xml and adjust the following line:

<php>
    <env name="DATABASE_URL" value="mysql://root@localhost:3306/contao_test" />
</php>

Then run the functional tests via the run command:

composer run functional-tests

License

Contao is licensed under the terms of the LGPLv3.

Getting support

Visit the support page to learn about the available support options.

You can’t perform that action at this time.