DoctrineExtensions/lib/Gedmo/Sortable/Sortable.php

<?php

namespace Gedmo\Sortable;

/**
 * This interface is not necessary but can be implemented for
 * Entities which in some cases needs to be identified as
 * Sortable
 * 
 * @author Lukas Botsch <lukas.botsch@gmail.com>
 * @package Gedmo.Sortable
 * @subpackage Sortable
 * @link http://www.gediminasm.org
 * @license MIT License (http://www.opensource.org/licenses/mit-license.php)
 */
interface Sortable
{
    // use now annotations instead of predifined methods, this interface is not necessary
    
    /**
     * @gedmo:SortablePosition - to mark property which will hold the item position use annotation @gedmo:SortablePosition
     *              This property has to be numeric. The position index can be negative and will be counted from right to left.
     * 
     * example:
     * 
     * @gedmo:SortablePosition
     * @Column(type="int")
     * $position
     * 
     * @gedmo:SortableGroup
     * @Column(type="string", length=64)
     * $category
     * 
     */
    
    /**
     * @gedmo:SortableGroup - to group node sorting by a property use annotation @gedmo:SortableGroup on this property
     * 
     * example:
     * 
     * @gedmo:SortableGroup
     * @Column(type="string", length=64)
     * $category
     */
}