enhavo/enhavo

Modern CMS with shop features based on fullstack symfony and sylius components

The enhavo CMS is a open source PHP project on top of the fullstack Symfony framework and uses awesome Sylius components to serve a very flexible software, that can handle most of complex data structure with a clean and usability interface.

Enhavo is still under heavy development and we can't guarantee for backward compatibility or security issues nor is our documentation up to date. So we advice you to not use the software for production until we reach a stable release.

Get started

If you just want to use enhavo, you don't need to install this repository. Read the Get Started tutorial to install your own enhavo application.

Demo

If you want to check the enhavo look and feel. Take a look at our demo on demo.enhavo.com

User	Password
[email protected]	admin

Contribute

Help us to develop the software. This is the main repository of the enhavo project. Feel free to open tickets or pull requests or just give us feedback. If you are a github user, you can star our project.

---

If you want to contribute code, you need to run the main repository. Make sure you have installed composer and yarn on your local machine. Fork and clone the repo and add a .env.local file containing your database credentials.

DATABASE_URL=mysql://db_user:[email protected]:3306/enhavo

And a test config .env.test.local containing your test database credentials.

DATABASE_URL=mysql://db_user:[email protected]:3306/enhavo_test

Execute following commands on your shell:

$ composer install
$ yarn install
$ yarn encore dev
$ yarn routes:dump
$ bin/console doctrine:database:create
$ bin/console doctrine:database:create --env=test
$ bin/console doctrine:migrations:migrate
$ bin/console doctrine:migrations:migrate --env=test
$ bin/console enhavo:init
$ bin/console enhavo:user:create --super-admin

Make your changes and run the tests.

$ bin/phpunit
$ bin/behat
$ bin/mocha
$ bin/karma

Testing stack

Depending on what you are going to test, choose the right tool.

<----------------------------- Behat ---------------------------------------->
<------------- PHPUnit ---------------->
                                        <------------- Karma ---------------->
                                        <------ Mocha --->
[**** Database ****][**** PHP File ****][**** JS File ****][**** Browser ****]

Documentation

The documentation is available at docs.enhavo.com.

---

If you want to contribute to the documentation you need sphinx. Read sphinx-doc.org to install it. For the --watch option you have to install sphinx-autobuild.

Fork and clone this repository and make your changes under docs/source. After each change run following command and open the build/docs/index.html in your browser to see and valid your changes.

$ bin/docs
$ bin/docs --watch

MIT License

License can be found here.

enhavo's Issues

[Documentation] Translation Guideline

To avoid structural inconsistency in translation files, a guideline should be created defining the keys to use based on where the translation will be used. Alternatively, the structure could also reflect the position in the code where the translation is used.

The current translation files should be structured accordingly, and future changes should refer to that guide.

Possible suggestions:
{entity}.{route, e.g. table/form}.{top-element}.{sub-element}.{type, e.g. label/message/error}
e.g. page.form.change_frequency.weekly.label
{entity}.{route, e.g. table/form}.{type, e.g. label/message/error}.{top-element}.{sub-element}
e.g. page.form.label.change_frequency.weekly

Increase Session Timeout

When writing a long article it is possible user gets logged out after submitting his form.
Solution would be to increase the session timeout to a minimum of 30 minutes or even better to 60 minutes.

[FormBundle] Cancel button for picture upload

General Translation

We need translations for most of our components. At the beginning we just start with german and enlish language.

This translation guide may help us to organize the translation files and structure
http://obtao.com/blog/2013/06/how-to-organize-your-translations-in-symfony/

Upgrade to Sylius v0.16

The current version of Sylius is v0.16. So we should update the SyliusResourceBundle

[EnhavoAppBundle] Batch-Actions for tables

Tables should allow batch delete and maybe other batch actions (e.g. publish)

[EnhavoMediaBundle] show file symbol instead broken image

If a file was uploaded which is no picture, we get a broken image, cause we try do display that picture.
Instead of the broken image we should show a file icon. The best would be to show different icons for the file types.

Login popup

At the moment, whenever the user gets a session timeout, the next request will return a login screen. This next request can be a form post or an ajax request, resulting in lost form data or failed ajax without a proper message for the user.

There should be a login popup and a saving/resending mechanism for form data for these cases.

Image Cropper

We need some cropper functionality for our media files.

[EnhavoArticleBundle]Form building doesn't work in debug true

If debug = true in parameters.yml, building the backend form for articles will return a 500 error page: "Notice: Undefined index: label.yes" (delivered as Ajax answer).

Traced the error to Symfony FormBuilder trying to create choices for Article field 'social_media'.

[EnhavoAppBundle] Frontend accessable with link in backend

User can change his password

As a user i want to change my password.

Atm, only with the user list we can change password, but we should provide a quick menu to change only his own password.

Loading Feedback

A user should get feedback if he start ajax calls. This could just be a loading git. Also the user is not allowed to send the request again. This is important for post requests.

At the moment i just sees these actions, where we need some feedback:

• Loading table
• Save
• Create
• Preview

[EnhavoCategoryBundle] CategoryEntityType

The class option should be injected and it should be the same as the config

enhavo_category.category.model.class

dynamic BlockFactory types

Atm the BlockFactory can only create blocks that are hardcoded inside the BlockFactory class. Of course we should offer a central configuration to set up the possible block types and load them dynamically inside our factory.

save content from article

contents get lost when you are saving the article

[EnhavoAppBundle] Change password button not responsive

For resolutions below 763px the change password button ends up in a bad position.

[EnhavoAppBundle] Button-icons in overlay configurable in route

The Icons before the buttons in the create/edit overlays currently do have a way to be configured in the route, but this configuration is overridden by the default style and ignored. This should be corrected.

BDD Testsuite

We already include Behat, but no test yet.

[EnhavoSliderBundle] Slides sortable

Atm there is no functionality to sort the slides.

[AppBundle] Match sortable behaviour with Doctrine extension Sortable

Currently we use our own implementation to handle sortable resources. Sylius uses the Sortable behavior extension for Doctrine2.

We should check if using the extension would be preferable, or maybe compare implementations for pros and cons to improve our implementation and find possible incompatibilities and errors.

[EnhavoGridBundle] also using form service in item configuration

At the moment we can configure our items in the config like this:

esperanto_content:
    items:
        youtube:
            model: esperanto\ProjectBundle\Entity\Youtube
            form: esperanto\ProjectBundle\Form\Type\YoutubeType
            repository: esperantoProjectBundle:Youtube
            template: esperantoProjectBundle:ItemType:youtube.html.twig
            label: Youtube

You can see that for the form class we use a concrete class name, but we should give the user also the possibility to use the form as a service.

So this should also be possible:

esperanto_content:
    items:
        youtube:
            model: esperanto\ProjectBundle\Entity\Youtube
            form: esperanto_content_item_youtube
            repository: esperantoProjectBundle:Youtube
            template: esperantoProjectBundle:ItemType:youtube.html.twig
            label: Youtube

SCSS

We want to use scss but also stay compatible to environment without ruby. So we should offer https://github.com/leafo/scssphp as well.

Migration Bundle

We need a bundle for housing data migration commands, e.g. to convert database structure changes between framework versions.

Bower

We should use bower for our asset dependencies. But as we will deploy things on environment without nodejs we should offer https://github.com/Bee-Lab/bowerphp as well.

Configurable Dynamic Routing

We don't need the dynamic routing in every project. At default it should be turned off, but it easy to turn on again.

[EnhavoAppBundle] Sort using drag&drop

Sortable table should be sortable using drag&drop

Ajax feedback if logout

If you get logged out while you are in the admin, you should receive some message to log in again.
Atm the login promt appears. This is good but should give the user more feedback about what happend.

[EnhavoContactBundle] subject translation

The subject should be translatable

[EnhavoAppBundle] table widget

We need a better widget system. Sometimes we have more configurations, for some widget.

List Widget
This widget should list all entities of the collection comma separated (by default). The name for the entity should be configurated by the property parameter in the widget. This is like in the form bundle.

list:
    label: group
    property: groups
    widget:
         type: list
         property: name
         separator: ','

Template Widget
Like the widget we have now. Just print an Template

public:
    label: public
    property: public
    widget:
         type: template
         template: AppBundle::template.html.twig

Multiple Property Widget
Show more property in on cell

firstName:
    label: firstName:
    property: firstName
    widget:
       type: multiple_property
       properties:
          - firstName
          - lastName
       separator: ','

Behat CRUD Testing

We have now a small testsuite, but we need more tests. There are already crud features in the behat list, but not implement yet.

[EnhavoContactBundle] dynamic messages

If we send a message via the ContactBundle, we got atm this success message:

Nachricht erfolgreich gesendet!

This message should be configure over the enhavo.yml. By default it should also be translated.

[EnhavoMediaBundle] Mimetype guesser strategy

The FileService->addFile() function determines the files mime type by file extension. This could be solved in a symfony strategy-way allowing determination by file content or users hooking in their own strategy providers.

Replace PHPSpec through PHPUnit

At the moment we have some PHPSpec Test, but we want so switch to PHPUnit, because with Behat, we already have some BDD Testing and i think PHPUnit is more powerful and well known by other developers as PHPSpec.

Make link sidebar height responsive/scrollable

The left sidebar is not full accessible if the height is higher as the screen height. We need here some scrolling mechanism.

Returning to index-table after creating an entry results in infinite loading screen

Reproduce it like that:

• head over to an table/index-page with no entries yet (e.g. Articles or Categories)
• click on create
• assign a title
• click save
• experience infinite loading screen

[ArticleBundle] Wrong label for public-attribute + wrong german translation

• Form Type builder assigns "label.picture" instead of "label.public"
• "label.public" should be translated "Öffentlich" instead of "Veröffentlichen" in german

[EnhavoMediaBundle] manyToOne and oneToOne relationship

A manyToOne and oneToOne relationship should be possible to access the media file. Atm we only have manyToMany relationships. The problem is the esperanto_files form type, cause it can only handle collection. This should be changed.

Edit/Save Dialogue is getting closed on pressing enter

When focusing an input field, pressing enter closes the dialogue

Preview for Content

We need some preview function for our content. It must be easy to add a preview to an existing content like Page, News or any Content which was added by the user.

For the preview function we will us the same request as we save our content. This is possible because we can reuse the FormType to produce the Entity we look for to render the content.

In an other project we realize this over the resolver. We use the request for saving and send it to the render action.

<?php
  public function showAction(Request $request)
  {
    $news = $this->container->get('esperanto_news.news_resolver')->getNews($request);
    return $this->render('tempalte', array('data' => $news));
  }

The resolver decide if he use the request for an preview or for rendering the entity from db.
This could be an approach for this ticket, but it should be also possible with dynamic routing.

After we have an easy solution to add new preview functionality, it must be also add to the documentation.

[Layout] Too much spacing to button bar

In an opened overlay (e.g. creating a new article) there is far too much spacing between the last attribute-row and the button bar. CSS-class would be ".tabContentContainer". Is 80px. 50px should be fine though.

Check other overlays if spacing is fine (probably using the same class).

CSRF Token should be send at last

It is possible that while sending a request to the Server, the connection is getting interrupt (but the server still process that as a normal request), and we got lost data. To prevent this we can send the CSRF Token in the end, so the form is not valid and will not change the data in case of unexpected interrupt.

[EnhavoDownloadBundle] download class should be injected

We should inject %esperanto_download.model.download%

<?php
    $builder->add('download', 'entity', array(
        'class' => 'esperanto\DownloadBundle\Entity\Download'
    ));

[EnhavoNewsBundle] NewsRepository should have getPrevious and getNext function

Sometimes it is interesting to know to next and previous news by date, so we should add new functions to the NewsRepository.

getPrevious(News $news)
getNext(News $news)

In some cases it is possible that a news has exact the same date, then we should't get in a loop by calling the chaining the next function.

[EnhavoContentBundle] add video type

We need a video content item, which support vimeo and youtube by just an url.

[Layout]

Checkboxes-attributes are not aligned with rest of input fields. They are indented a bit.
Check the overlay for creating an article for example. you see "social media" or "public"-checkboxes are not aligned with "publication date"-input-field.

fix radio-buttons

When the value is 0 the checkbox is not selected

[FormBundle] js set dateTimePicker options dynamically

right now there is no possibility to influence the options used for dateTimePicker (this applies to other widgets as well). it should be possible to define options in a config file (like stepMinute, the wording of the "now"-button and so on).

[EnhavoMediaBundle] Additional information for files

We should save additional information for each media object and add forms to edit them.

For example:

• file name
• slug for routes
• alt tag

Some fields should be dynamical to allow each entity using media to define which fields to use.

[EnhavoAppBundle] assets manageable by routing

Stylesheet and javascript should be manageable by routing.

Example:

stylesheets:
    esperanto_app_style:
        resource: '@esperantoAppBundle/Resource/public/css/style.css'
        depends: ~
javascripts:
    esperanto_app_bootstrap:
        resource: '@esperantoAppBundle/Resource/public/js/bootstrap.css'
        depends: jquery