samsoncms / api

     * @param self $return Variable to return found database record

     * @return bool|null|self  Field instance or null if 3rd parameter not passed

     */

    public static function byNameOrID(QueryInterface $query, $nameOrID, self & $return = null)

    {

        // Create id or URL condition

        $idOrUrl = new Condition('OR');

        $idOrUrl->add('FieldID', $nameOrID)->add('Name', $field);

        // Perform query

        $return = $query->className('field')->cond($idOrUrl)->first();

        // If only one argument is passed - return null, otherwise bool

        return func_num_args() > 1 ? $return == null : $return;

    }

    /** @return string Get additional field value field name depending on its type */

    public function valueFieldName()

     * @param string $locale Locale identifier

     * @return bool|null|self  Field instance or null if 3rd parameter not passed

     */

    public static function byFieldIDAndMaterialID(

        QueryInterface $query,

        $materialID,

        $fieldID,

        self & $return = null,

        $locale = DEFAULT_LOCALE

    ) {

        $return = $query->className(__CLASS__)

            ->cond('MaterialID', $materialID)

            ->cond('FieldID', $fieldID)

            ->cond('locale', $locale)

            ->first();

        // If only one argument is passed - return null, otherwise bool

        return func_num_args() > 1 ? $return == null : $return;

    }

}

     * @return bool|self[] True if material entities has been found and $return is passed

     *                      or self[] if only two parameters is passed.

     */

    public static function byNavigationID(QueryInterface $query, $navigationID, &$return = array())

    {

        /** @var array $materialIds Collection of entity identifiers filtered by additional field */

        $materialIds = null;

        if (static::idsByNavigationID($query, $navigationID, $materialIds)) {

            $return = $query->entity(get_called_class())

                ->where('MaterialID', $materialIds)

                ->where('Active', 1)

                ->where('Published', 1)

                ->exec();

        }

        // If only one argument is passed - return null, otherwise bool

        return func_num_args() > 2 ? $return == null : $return;

    }

    public static function byNavigationIdAndFieldValue(QueryInterface $query, $navigationID, $fieldID, $fieldValue, &$return = array())

    {