samsoncms / api

     * @param string $locale Locale identifier

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

     */

    public static function byMaterialID(

        QueryInterface $query,

        $materialID,

        &$return = null,

        $locale = DEFAULT_LOCALE

    ) {

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

            ->where(Material::F_PRIMARY, $materialID)

            ->where(Material::F_DELETION, true)

            ->where(self::F_LOCALE, $locale)

            ->exec();

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

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

    }

    /**

     * Find additional field value database record by its material and field identifiers.

     * @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,

        &$return = null,

        $locale = null

    ) {

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

            ->where(Material::F_PRIMARY, $materialID)

            ->where(Field::F_PRIMARY, $fieldID)

            ->where(self::F_LOCALE, $locale)

            ->where(Material::F_DELETION, 1)

            ->exec();

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

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

    }

}