samsoncms / api

     * @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 byIDs(QueryInterface $query, $fieldIDs, &$return = array(), $executor = 'exec')

    {

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

            ->where('FieldID', $fieldIDs)

            ->where('Active', 1)

            ->orderBy('priority')

            ->$executor();

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

        return func_num_args() > 2 ? sizeof($return) : $return;

    }

    /**

     * Get current entity identifiers collection by navigation identifier.

     * @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 byIDs(QueryInterface $query, $materialIDs, &$return = array(), $executor = 'exec')

    {

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

            ->where('MaterialID', $materialIDs)

            ->where('Active', 1)

            ->where('Published', 1)

            ->$executor();

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

        return func_num_args() > 2 ? sizeof($return) : $return;

    }

    /**

     * Get self[] by field identifier and its value.

     * @param self|array|null $return Variable where request result would be returned

     * @return bool|self True if material entities has been found

     */

    public static function byUrl(QueryInterface $query, $url, & $return = array())

    {

        // Get entities by filtered identifiers

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

            ->where('Url', $url)

            ->where('Active', 1)

            ->first();

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

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

    }

    /**

     * Set additional material field value by field identifier