Important

You are browsing the documentation for version 4.2 of OroCommerce, OroCRM and OroPlatform, which is no longer maintained. Read version 5.1 (the latest LTS version) of the Oro documentation to get up-to-date information.

See our Release Process documentation for more information on the currently supported and upcoming releases.

How to Use the Draft Filter

To restrict access to draft entities on pages, use a query modification mechanism that is implemented in Doctrine Filters.

Follow the instructions provided in the Doctrine Filters topic for more details.

The system already has the DraftableFilterManager auxiliary manager that can be used to turn on/off the draft filter.

This example describes how to disable the draft filter. The following validator checks both unique and draft entities.

namespace ACME\Bundle\CMSBundle\Validator\Constraints;

use ACME\Bundle\CMSBundle\Entity\Block;
use Doctrine\ORM\EntityManager;
use Doctrine\Persistence\ManagerRegistry;
use Oro\Bundle\DraftBundle\Manager\DraftableFilterManager;
use Symfony\Component\Validator\Constraint;
use Symfony\Component\Validator\ConstraintValidator;
use Symfony\Contracts\Translation\TranslatorInterface;

/**
 * Checks if at least one record exists (includes draft entities).
 */
class UniqueTitleDraftValidator extends ConstraintValidator
{
    private ManagerRegistry $registry;

    private DraftableFilterManager $filterManager;

    private TranslatorInterface $translator;

    public function __construct(
        ManagerRegistry $registry,
        DraftableFilterManager $filterManager,
        TranslatorInterface $translator
    ) {
        $this->registry = $registry;
        $this->filterManager = $filterManager;
        $this->translator = $translator;
    }

    /**
     * @param string|null $value
     * @param UniqueTitleDraft|Constraint $constraint
     */
    public function validate($value, Constraint $constraint): void
    {
        /** @var EntityManager $entityManager */
        $entityManager = $this->registry->getManagerForClass(Block::class);
        $this->filterManager->disable(Block::class);
        $result = $entityManager
            ->getRepository(Block::class)
            ->findBy(['title' => $value]);

        $countResult = count($result);

        $this->filterManager->enable(Block::class);

        if (0 === $countResult || (1 === $countResult && $this->context->getObject() === current($result))) {
            return;
        }

        $message = $this->translator->trans($constraint->message);
        $this->context->buildViolation($message)->addViolation();
    }
}