Lily Software

File System

Tue, 24 Oct 2023 18:38:00 +0300

Компонент для работы с файловыми хранилищами на основе Flysystem.
Он позволяет работать как с локальной файловой системой, так и с удаленными хранилищами используя единый интерфейс. Например с Amazon AWS S3, Azure Blob Storage, Yandex Objet Storage, BunnyCdn, Google Cloud Storage, WebDav, FTP, SFTP и др.

Класс для работы с локальной файловой системой входит в состав Cotonti Lib и не требует доплнительной установки других библиотек. Его интерфейс совместим с \League\Flysystem\FilesystemOperator и они взаимозаменяемы.

Для подключения другой (удаленной) файловой системы нужно установить Flysystem и нужный адаптер.

Для этого в composer.json нужно добавить строки:

"league/flysystem": "^3.0",
"league/flysystem-aws-s3-v3": "^3.0"

В этом примере мы добавили адаптер для файловых хранилищ, поддерживающий AWS S3.

И выполнить в командной строке:

composer update

Composer для Windows имеет баг который может в файле lib/composer/autoload_static.php сделать что то такое:

public static $fallbackDirsPsr4 = array (
  0 => 'C:\\OpenServerData\\domains\\my-site.loc\\public_html\\lib',
);

Надо вернуть как было:

public static $fallbackDirsPsr4 = array (
  0 => DIR . '/../..' . '/lib',
);

Теперь адатер файловой системы готов к использованию в коде Ваших расширений.

Для создания экземпляра можно воспользоваться инструкцией к соотвествующему адаптеру или воспользоваться "фабрикой" из Cotonti Lib.
Использование фабрики является предпочтительным при создании расширений т.к. позволяет конфигурировать подключения к файловым системам и использовать нужные в зависимости от конфигурации.

Конфигурирование файловых систем.

В файл datas/config.php нужно добавить элемент такого вида:

$cfg['filesystem'] = [
	
    // Подключение к Yandex Object Storage
    'Yandex.Cloud' => [
        'adapter' => '\League\Flysystem\AwsS3V3\AwsS3V3Adapter',
        'config' => [
            //'version' => 'latest', // Optional
            'endpoint' => 'https://storage.yandexcloud.net',
            'region' => 'ru-central1',
            'bucket' => 'my-bucket-name',
            'accessKey' => 'MyAccessKey',
            'secretKey' => 'MySecretKey',

            // install: composer require league/flysystem-path-prefixing:^3.3 to use prefix
            //'pathPrefix' => 'a/path/prefix',
        ],
    ],
	
    // Подключение к другому серверу по FTP
    'FTP' => [
        'adapter' => '\League\Flysystem\Ftp\FtpAdapter',
        'config' => [
            'client' => [
                'host' => 'my-pretty-host.tld',
                'root' => '/var/www/files/storage/here',
                'username' => 'server-user',
                'password' => 'someThingReallySecret',
            ],

            // install: composer require league/flysystem-path-prefixing:^3.3 to use prefix
            //'pathPrefix' => 'a/path/prefix',
        ],
    ],
	
    // Подключение к BunnyCDN
    'BunnyCDN' => [
        'adapter' => '\PlatformCommunity\Flysystem\BunnyCDN\BunnyCDNAdapter',
        'config' => [
            'storageZoneName' => 'test-files',
            'apiKey' => 'my-api-key',
            'pullZoneUrl' => 'https://test-files.b-cdn.net',
            //'region' => 'de', // optional

            // install composer require league/flysystem-path-prefixing:^3.3 to use prefix
            //'pathPrefix' => 'a/path/prefix',
        ],
    ],
];

В этом примере мы сконфигурировали подключение к Yandex Object Storage и к удаленному серверу по FTP.

Ключ массива - это название подключения, может быть любым.

'adapter' - имя класса адаптера. Поддерживаются и псевдонимы. Например вместо '\League\Flysystem\AwsS3V3\AwsS3V3Adapter' можно использовать 'Aws' или 'AwsS3'. Фабрика их поймет.

'config' - конфигурация подключения. Т.к. файловые системы имют очень разные API и способы подключения, то для каждого адаптера 'config' свой.
За подробностями можно обратиться к описанию самого адаптера и в код файла фабрики.

Если вы хотите добавить в фабрику подключение адаптера, которого в ней нет или создать подключение с более специфичной конфигурацией, то это можно сделать либо через хук filesystem.getFilesystem либо определив функцию cot_getFilesystem($fileSystemName, $pathPrefix).

Пример использования:

use \filesystem\FilesystemFactory;

// Получить экземпляр класса файловой системы по имени подлючения из конфига выше
$filesystem = FilesystemFactory::getFilesystem('Yandex.Cloud');

// Запись в файл
$filesystem->write($path, $contents);

Методы класса \League\Flysystem\Filesystem описаны в документации.

Image bundle

Tue, 24 Oct 2023 12:48:00 +0300

Компонент для работы с изображениями. Работает как с библиотекой GD, так и с ImageMagick. Последняя поддерживает большее количество форматов изображений, в т.ч. HEIC/HEIF, которые используются в смартфонах iPhone от Apple.

По умолчанию, если устанвлена ImageMagick, то используется она.

Чтобы использовать этот компонент в Ваших расширениях, добавте в начало php-файла

Получить используемый драйвер:

$driver = Image::currentDriver();

Метод возвращает одну из констант: Image::DRIVER_IMAGICK или Image::DRIVER_GD или null, если ни одна из библиотек недоступна и обработка изображений невозможна.

Получить список поддерживаемых форматов в виде массива:

$supportedFormats = Image::supportedFormats();

Загрузка изображения для дальнейшей обработки:

$image = Image::load($path, ?array $options = null);

в $path можно передать
- строку с путем к файлу или URL удаленного файла
- ресурс, полученный от fopen()
- строку с бинарными данными, содержащими избражение или строку закодированную в base64 c бинарными данными изображения
- data URL

в $options можно указать какой именно использовать, например:

$image = Image::load('/path/to/file', ['driver' => Image::DRIVER_GD]);

Этот метод возвращает экземпляр класса \image\imagick\Image или \image\gd\Image, которые являются наследниками класса \image\AbstractImage. Или будет выброшено исключение в случае неудачи.

Методы класса для работы с изображениями:

Можно получить экземпляр класса \Imagick или \GdImage|resource (в зависимости от используемой библиотеки) и работать с ними напрямую:

$image->getData();

Сохранить изображение:

$image->save(?string $fileName = null, ?int $quality = null, ?string $format = null);

$fileName - полный путь и имя файла для сохранения. Если не указано, то изменения будут сохранены в ранее загруженный файл. Иначе будет создан новый файл, а старый останется без изменений.

$quality - качество. Используется только если формат сохраняемого файла поддерживает этот параметр.

$format - формат сохраняемого изображения. Если не указано, будет использовано расширение файла.

Кодирование формата в указанный формат:

$image->encode(string $format, ?int $quality = null, ?string $fileName = null);

$format - формат изображения. Например: 'jpeg', 'png', 'heif'. Или 'data-url' для кодирования изображения в data Url;

$quality - качество. Используется только если формат сохраняемого файла поддерживает этот параметр.

$fileName - Имя файла для сохранения изображения. Если null - изображение будет возвращено в виде строки бинарных данных.

$image->crop(int $width, int $height, ?int $x = null, ?int $y = null);

Обрезает изображение.

Параметры $x и $y координаты правого верхнего угла области для нового изображения.

$width и $height - ширина и высота области нового изображения.

$image->fixOrientation();

Поворачивает изображение в соотвествии с данными об ориентации из EXIF

$image->flipHorizontally();
$image->flipVertically();

Отразить изображение горизонтально или вертикально соотвественно

$image->getWidth();
$image->getHeight();

Возвращают ширину и высоту изображения.

$image->getOrientation();

Возвращает ориентацию изображения из EXIF.

$image->paste(AbstractImage $image, $x, $y, $alpha = 100);

Вставляет одно изображение в другое. Может использоваться для наложения "водяного знака" или создания коллажей.

$image - вставляемое изображение. Экземпляр класса \image\imagick\Image или \image\gd\Image,

$x, $y - координаты левого верхнего угла вставляемого изображения

$alpha - прозрачность вставляемого изображения. 0 - полностью прозрачное. 100 - полностью непрозрачное.

$image->removeAnimation()

Удаление анимации. Gd и так не поддерживает анимацию. При использовании Imagick, в изображении будет оставлен только первый кадр.

$image->resize($width = null, $height = null, string $filter = Image::FILTER_UNDEFINED)

Изменение размера изображения.

$width, $height - новые ширина и высота изображения. Могут указываться как целое число в пикселях (1920) или процент ('80%'). Если ширина или высота не указана (null), то ее значение будет расчитано пропорционально.

$filter - фильтр применяемый для масштабирования. Одна из констант \image\Image::FILTER_XXX. GD не поддерживает фильтров и игнорирует этот параметер.

$image->rotate($angle, $background = null)

Поворачивает изображение на указанное количество градусов

$image->strip()

Удаляет EXIF данные из изображения. Gd удаляет эти данные в любом случае.

$image->thumbnail(
    $width, 
    $height, 
    string $resize = Image::THUMBNAIL_OUTBOUND, 
    bool $upscale = false, 
    string $filter = Image::FILTER_LANCZOS
)

Создает миниатюру изображения

$resize - как создавать миниатюру. Одна из констант:

\image\Image::THUMBNAIL_OUTBOUND - масштабирует изображение пропорционально таким образом, чтобы его ширина и высота были не меньшне указанных размеров. Если вторая сторона при этом превышает указанное значение - она обрезается.
\image\Image::THUMBNAIL_INSET - Исходное изображение масштабируется таким образом, чтобы оно полностью умещалось в размерах миниатюры (соотношение ширины и высоты изображения не меняется).
\image\Image::THUMBNAIL_HEIGHT - Миниатюра масштабируется так, чтобы ее высота равнялась желаемой высоте (соотношение ширины и высоты изображения не меняется).
\image\Image::THUMBNAIL_WIDTH - Миниатюра масштабируется так, чтобы ее ширина равнялась желаемой ширине (соотношение ширины и высоты изображения не меняется).

$upscale - увеливать изображение, если оно меньше указанных размеров.

Пример использования. Сделаем из исходного изображения миниатюру 160x160 и сохраним ее в формате jpeg:

$image = Image::load('/path/to/image.heic');

// Сделаем миниатюру
$image->thumbnail(160, 160, Image::THUMBNAIL_OUTBOUND);

// Сохраним в формате JPEG
$image->save('/path/to/image_160x160.jpg', 80);

// Выгрузим изображение из памяти:
unset($image);

Cotonti - Files

Tue, 16 Aug 2022 08:17:00 +0300

Модуль для CMF Cotonti.

тип: модуль
Версия модуля: 2.1.0
Совместимость: Siena

GitHub: https://github.com/Alex300/files

Модуль организует управление вложениями к страницам, постам и любым другим объектам, создание фотогалерей на страницах и постах. А также совмещает в себе персональное файловое хранилище пользователей, файловое хранилище сайта для администраторов, управление аватарами и альбомами пользователей.
Он является заменой модуля PFS, плагина «User images», входящих в «коробку» Cotonti и плагина «Attach2».

1. Особенности

Хранение файлов как в локальной файловой системе на сервере, так и в удаленных файловых хранилищах, таких как Amazon AWS S3, Azure Blob Storage, Yandex Objet Storage, BunnyCdn, Google Cloud Storage, WebDav, FTP, SFTP и др.
Современный механизм загрузки основанный на jQuery File Upload
Поддержка мультизагрузки.
Петаскивание файлов мышью прямо на форму загрузки.
Загрузка файлов по-частям («Чанками») позволяет обойти ограничение на загрузку файла через $_POST в 2 мб.
Использование для обработки изображений как библиотеки GD, так и ImageMagick. Последняя поддерживает большее количество форматов изображений, в т.ч. HEIC/HEIF, которые используются в смартфонах iPhone от Apple.
Уменьшение больших изображений до указанных размеров при загрузке.
Использование водяного знака (watermark) для изображений.
Простая интергация через обратный вызов функций из шаблона.
Загрузки подсчитываются и происходят с оригинальным именем файла.
Создание изображений для предпросмотра (thumbnail) и простая его настройка.
Поддержка экстраполей.
Специальные ББкоды для вставки изображений и галлерей в текст страниц вне зависимости от выбранного парсера.
Поддерживаемые форматы изображений библиотекой GD: .avif, .bmp, .gif, .jpg, .png, .tga, .tpic, .wbmp, .webp, .xbm
Поддерживаемые форматы изображений библиотекой Imagick.

2. Системные требования и ограничения:

Установленная Cotonti Siena версии не ниже 0.9.24 beta. (Files v. 1.0.8 совместим с Cotonti Siena 0.9.18)
PHP версии 7.4 и выше. (Files v. 1.0.8 совместим с PHP v 5.4)
.bmp библиотекой GD поддерживается на PHP >= 7.2,
.tga библиотекой GD загрузка поддерживается на PHP >= 7.4, уменьшенные копии изображений создаются в JPEG
.avif библиотекой GD поддерживается на PHP >= 8.1
Для использования удаленного файлового хранилища требуется установленная Flysystem и соотвествующий адаптер.
jQuery File Upload выводит превью при загрузке изображений не для всех указанных форматов.
Наличие на Вашем сайте установленной библиотеки Cotonti Lib версии 2.2.x
Модуль не совместим с модулем PFS и плагином «User images». Их не следует устанавливать, если Вы собираетесь использовать модуль «Files».
Шаблоны "в коробке" расчитаны на использование темы, реализованной на фреймворке Bootstrap v3 (Устанавливается отдельно)

Замечание. В силу значительно отличающейся структуры БД и способа хранения файлов, модуль «Files» не подхватит автоматически присутсвующие на сайте файлы из модуля «PFS» и плагинов «User images» и «Attach2».

2.1 Перенос данных из модуля «PFS» и плагинов «User images» и «Attach2».

Если Вы хотите использовать модуль «Files» для уже существующего сайта, Вам следует использовать конвертер для переноса данных между модулями. Вы можете заказать его здесь. В настоящий момент существует конвертер для переноса данных из этих трех расширений, т.к. они одни из самых часто используемых. Но можно сделать конвертер для любого другого модуля или плагина.

3. Установка

Загрузить архив и распаковать в папку с модулями вашего сайта.
В меню «Управление сайтом > Расширения» произвести установку нажав «установить».
В настройках модуля выберите подходящие Вам установки.
В шаблонах панели управления «admin.users.tpl» и «admin.users.tpl» а также в некоторых других создайте теги в соотвествии с рекомендациями на настранице модуля в панели управления. (https://<ваш_домен>/admin/extensions?a=details&mod=files)
При необходимости на странице редактирования групп пользователей установите ограничения на размер загружаемого файла, общее файловое пространство пользователя и максимальное количество вложений для одного объекта. Для каждой группы пользователей могут действовать свои разрешения.
Обратите внимание, что размеры указываются в байтах, ноль означает «безлимит», а -1 - запрет.
Создайте каталог для файлов на вашем сервере (по умолчанию используется «datas/files») и установите права на запись для PHP (например CHMOD 775 или CHMOD 777).
Используйте в Вашей теме Resources::setAlias() для объявления алиясов для файлов Bootstrap, если Вы планируете его использовать и он установлен в папку, отличную от объавленной в классе Resources.

3.1 Загрузка файлов в удаленное хранилище

Для хранения файлов можно использовать как локальную файловую систему на сервере с сайтом, так и в удаленные файловые хранилища, такие как Amazon AWS S3, Azure Blob Storage, Yandex Objet Storage, BunnyCdn, Google Cloud Storage, WebDav, FTP, SFTP и др.

Для использования локальной файловой системы ничего дополнительно устанавливать и настраивать не нужно.

Для использования удаленного файлового хранилища требуется установленная Flysystem и соотвествующий адаптер. Как установить и сконфигуририровать подключение к нужному файловому хранилищу читайте в соотвествующей статье.

После этого нужно настроить использование файловых систем модулем файлов. Если вы хотите использовать по-умолчанию удаленное файловое хранилище вместо локального или использовать одно удаленное файловое хранилище для хранения всех файлов, то на предыдущем этапе нужно сконфигурировать подключение с именем default. Например, в datas/config.php добавте:

$cfg['filesystem'] = [
    // Подключение к Yandex Object Storage будет использоваться по-умолчанию
    'default' => [
        'adapter' => '\League\Flysystem\AwsS3V3\AwsS3V3Adapter',
        'config' => [
            //'version' => 'latest', // Optional
            'endpoint' => 'https://storage.yandexcloud.net',
            'region' => 'ru-central1',
            'bucket' => 'my-bucket-name',
            'accessKey' => 'MyAccessKey',
            'secretKey' => 'MySecretKey',
 
            // install: composer require league/flysystem-path-prefixing:^3.3 to use prefix
            //'pathPrefix' => 'a/path/prefix',
        ],
    ],
];

Кроме подключения по-умолчанию вы можете настроить файловые хранилища для отдельных обдектв (страниц, постов, галерей и т.п.). Например, в datas/config.php добавте:

$cfg['files']['storages'] = [

    // Файлы с source='page' загружать на Google.Drive
    'Google.Drive' => ['page'],

    // Или можно указать и так
    'Yandex.Cloud' => [
        ['source' => 'page'],
    ],

    // А файлы галерей, прикрепленные к страницам (с source='page' и source_field='gallery')
    // загружать на BunnyCDN.
    'BunnyCDN' => [
        ['source' => 'page', 'field' => 'gallery'],
        ['source' => 'page', 'field' => ['gallery', 'someField']], // Так тоже можно
    ],
];

Здесь ключ массива - это название подключения, которое указали при конфигурировании подключений. Для использованя локальной файловой системы укажите 'local' (имеет смысл только если подключение по-умолчанию - не локальное франилище).
source и field будут объяснены ниже.

4. Использование

Этот раздел рассказывает об основных моментах использования модуля на страницах (pages) c минимальными изменениями сайта. Аналогично можно настроить его для применения с другими разделам сайта, как например темы форума или комментарии.

Большинство примеров указаны для темы оформления c подключенным Bootstrap, т.к. его использует jQuery File Upload, но Вы всегда можете сделать свои CSS стили не используя bootstrap. Вы можете переопределить шаблоны для решения Ваших задач.

4.1 Личное файловое хранилище. Альбомы пользователей.

Модуль Файлов предоставляет пользователям персональное файловое хранилище ( и файловое хранилище сайта для администраторов ). Файлы можно хранить по папкам и альбомам. Публичные папки и альбомы пользователя доступны для просмотра другим пользователям. Также Вы можете вставить на страницу, точнее прямо в редактор (CKEditor или MarkitUp или другой), ссылку на файл, изображение, его миниатюру или весь альбом в виде галереи.

Чтобы иметь возможность вставлять файлы в редактор из личного файлового хранилища или файлового хранилища сайта, на форме редактирования страницы нужно добавить теги {PAGEEDIT_FORM_PFS} {PAGEEDIT_FORM_SFS} - в форму редактирования и {PAGEADD_FORM_PFS} {PAGEADD_FORM_SFS} в форму добавления страницы.

Также мои файлы доступны на отдельной странице: https://<ваш_домен>/files?m=pfs - можно добавить ее в меню пользователя как "Мои файлы"

Файловый архив сайта: https://<ваш_домен>/files?m=pfs&uid=0

Публичные файлы и альбомы пользователя другим пользователям доступны по ссылкам:
https://<ваш_домен>/files?a=files&uid= - файлы
https://<ваш_домен>/files?a=album&uid= - альбомы

Можно добавить их в профиль пользователя.

4.2 Аватары пользователей

В стандартных шаблонах модуля пользователей Cotonti - users.profile.tpl и users.edit.tpl уже есть теги {USERS_PROFILE_AVATAR} и {USERS_EDIT_AVATAR} соотвественно. Модуль на их место выводит форму загрузки аватара пользователя. А тегом{USERS_DETAILS_AVATAR} (или {PAGE_OWNER_AVATAR} или {ЛЮБОЙ_ПРЕФИКС_AVATAR}, если тег генерируется функцией cot_generate_usertags()) аватар выводится в шаблон. Кроме того, для вывода аватара в шаблон Вы можете использовать например такую конструкцию:

или

Функция

cot_filesUserAvatarUrl($fileId, $width = 0, $height = 0, string $frame = ''): string

как видите принимает 4 параметра, из которых обязательным является только первый - id файла - аватара. Также Вы можете указать длину, ширину и способ кадрирования, если Вы не хотите использовать настройки модуля по-умолчанию.

Также для вывода аватаров доступна функция

cot_filesUserAvatar($file_id = 0, $urr = 0, $width = 0, $height = 0, $frame = ''): string

в отличие от cot_filesUserAvatarUrl(), она возвращает полный html код аватара включая тег и если у пользователя не установлен аватар, она выводит аватар по-умолчанию.

4.3 Вложения

Это самая сложная, самая гибкая и самая интересная возможность использования этого модуля. На ней стоит остановиться подробнее. Модуль Файлов позволяет не только вставлять ссылки и миниатюры в редактор, как это было описано выше, но и позволяет прикреплять к любым объектам, например страницам или постам на форуме, вложения, файлы для скачивания и галереи изображений. Кроме того, модуль умеет загружать файлы к еще пока не существующим объектам, например к странице, которая только создается. И не стоит беспокоиться о том, что останутся бесхозные файлы, если пользователь так и не сохранит страницу, система уборки вычистит файлы, если объекты для которых они предназначались, так и не были созданы.

При удалении страницы или поста на форуме модуль также сам удалит все прикрепленные к ним файлы. А вот для любых других объектов (а также если Вы используете модуль в своих модулях или плагинах) при удалении объектов, нужно позаботиться об удалении и прикрепленных к нему файлов. Но эта процедура крайне проста. Можно действовать по аналогии со скриптом files.page.delete.php, который удаляет все вложения при удалении страницы.

Прежде, чем мы сможем использовать вложения, нам нужно их добавить. Сделать это можно несколькими способами:

4.3.1 Добавление элемента загрузки файла на форму создания/редактирования объекта

В шаблон page.add.tpl добавте код

{PHP|cot_filesFileBox('page', 0)}

А в шаблон page.edit.tpl

{PAGEEDIT_FORM_ID|cot_filesFileBox('page', $this)}

Для добавления вложений к страницам этого достаточно. На месте тегов будет выведен загрузчик как на иллюстрации ниже. Хотите большего? Тогда дочитайте этот параграф до конца.

ID пока несуществующих (новых) объектов всегда указывается равным 0.

Функция

function cot_filesFileBox(
    string $source,
    $item,
    string $name = '',
    string $type = 'all',
    $limit = -1,
    string $tpl = 'files.filebox',
    $standalone = 0,
    $userId = null
): string

Принимает следующие параметры:

$source - тип объекта или имя модуля. Например: page
$item - id объекта. К примеру, это ID страницы, ID поста на форуме или ID комментария. Ключевое слово шаблонизатора CoTemplate $this позволяет передать в этот параметр значение тега.
$name - имя поля. Можно оставить пустым. Но мы можем для одной страници прикреплять отдельно логотип, отдельно остальные файлы. Или придумать более замысловатую схему прикрепления вложений.
$type - тип загружаемых файлов. 'all' - все сайлы или 'file' или 'image'
$limit - Ограничение на количество загружаемых файлов. Если указан -1 - то будут использованы ограничения, действующие для группы, которой принадлежит пользователь. 0 - не ограничено.
$tpl - шаблон виджета загрузки файлов.

Обратите внимание. Шаблон виджета по умолчанию использует библиотеку Bootstrap но сам его не загружает. Вы должны подключить bootstrap самостоятельно. Или добавте свои CSS стили. По своему усмотрению.

На этой иллюстрации на форме редактирования страницы присутствует два загрузчика файлов. Первый для загрузки картинки для вывода в списках страниц (логотипа с параметром $name = 'logo'), а второй для формирования галери с названием поля - 'gallery'. Конечно для вывода в списки страниц можно было взять первую (или последнюю) картину из поля 'gallery' и обойтись одним загрузчиком. Но нужно было иметь возможность поставить в качестве логотипа произвольное изображение.

Вот как это реализовано:

В шаблон page.add.tpl добавлен код:

{PHP|cot_filesFileBox('page', 0, 'logo')}
{PHP|cot_filesFileBox('page', 0, 'gallery')}

а в шаблон page.edit.tpl

{PAGEEDIT_FORM_ID|cot_filesFileBox('page', $this, 'logo')}
{PAGEEDIT_FORM_ID|cot_filesFileBox('page', $this, 'gallery')}

Картинку из первого загрузчика можно выводить, например в списках страниц или сверху страницы:

а со второго - использовать как галерею на самой странице:


{PAGE_ID|cot_filesGallery('page', $this, 'gallery')}

Интерфейс загрузчика файлов достаточно стандартен и понятен. Он позволяет выбрать один или несколько файлов за 1 раз, загрузить их, позволяет удалять загруженные, заменять файлы и редактировать описания посредством. Для настройки необходимой последовательности файлов просто перетаците соответствующую строку (Drag & Drop).

И еще один важный момент. Возможность загружать файлы к создаваемому объекту не будет работать при "массовом создании" объетов. Только одна форма создания одного объекта на странице. Это не относится к массовому редактированию объектов.

Если Вы используете модуль Файлов с дугими объектами (или в своих модулях / плагинах) и используете загрузку файлов к пока не существующим объектам, Вам нужно сразу после сохранения объекта и до любого редиректа вызвать метод

\cot\modules\files\services\FileService::linkFiles($source, $item)

Он выполняет привязку уже загруженных файлов к только что созданому объекту. Принимает 2 параметра:

$source - тот же $source, что был передан для функции cot_filesFileBox(),
$item - id только что созданного объекта

Для модуля страниц вызывать FileService::linkFiles($source, $item) не нужно. Это уже сделано в файле files.page.add.add.done.php. С другими объектами следует действовать по аналогии с ним.

При сохранении существующих объектов после редактирования (объектов у которых уже есть свой id, который передавался в функцию cot_filesFileBox()) вызывать FileService::linkFiles($source, $item) также не нужно. Файлы к таким объектам «привязываются» сразу, в момент загрузки.

4.3.2 Добавление загрузчика в iframe

В шаблон page.edit.tpl

{PAGEEDIT_FORM_ID|cot_filesWidget('page', $this)}

Это добавит iframe с загрузчиком файлов для существующего объекта.

Функция

cot_filesWidget(string $source, $item, string $field = '', string $tpl = 'files.widget', $width = '100%', $height = '300'): string

Эта функция используется для создания виждета прикрепления файлов. Давайте взглянем на параметры:

$source - определяет тип содержимого к которому прикрепляются файлы или код модуля или плагина. Например 'page', 'forums', 'comments', и т.п..
$item - ID объекта, к которому прикрепляются файлы.
$field - имя поля. Можно оставить пустым. Позволяет к одному объекту прирепить несколько групп файлов.
$tpl - Код шаблона, содержащего html код виджета. Например, если Вы укажете 'files.my_widget', система попытается срендерить файл «themes/your_theme/modules/files/files.my_widget.tpl». Шаблоны по умолчанию можно найти в папке «modules/files/tpl», Вы можете использовать их как образец. «files.widget» вставляет диалог в iframe, а «attach2.link» (см. далее) добавляет ссылку на всплывающий диалог с загрузчиком.
$width - Ширина iframe.
$height - Высота iframe.

Замечание. Т.к. подключаемый виджет содержится в iframe, то хоть он по умолчанию и использует Bootstrap, но на дизайне Вашего сайта это никак не скажется, если Вы Bootstrap не используете. Виджет сам подключает Bootstrap, так что никаких дополнительных действий предпринимать не требуется

4.3.3 Добавление ссылки и диалога загрузки файлов.

Модуль позволяет добавлять файлы не только во время редактирования объекта, но и прямо во время просмотра.

Добавим ссылку "Прикрепить файлы" в меню администрирования страницы, в шаблон page.tpl


{PAGE_ID|cot_filesWidget('page', $this, '', 'files.link')}

Эта ссылка будет видна только тем пользователям, которые имеют права на прикрепление файлов (которое определяется правом «записи» (Write access) в настойках прав этого модуля).

Если нажать на ссылку "Прикрепить файлы", откроется окно следующего окно:

После того как вы загрузили все необходиомое и написали описания нажмите «закрыть», после чего содержимое страницы обновится и вы увидите результат.

Также среди шаблонов по умолчанию в папке модуля «modules/files/tpl» есть шаблон виджета «files.link.bootstrap.tpl», который открывает загрузчик в модальном окне Bootstrap. По аналогии очень легко сделать так, чтобы загрузчик открывался в диалоговом окне jQuery.UI.

4.3.4. Просмотр прикрепленных файлов

Самый простой способ вывода прикрепленных к странице файлов это использовать виджет cot_filesDisplay() в шаблоне «page.tpl»:



    {PHP.L.files_attachments}
    {PAGE_ID|cot_filesDisplay('page', $this)}

Который отобразит примерно следующее:

4.3.5. Добавление простой галереи

Для добавления простой галереи на страницу, вы можете включить в шаблон «page.tpl» следующий код:



    {PAGE_ID|cot_filesGallery('page', $this)}

Он добавит галерею на страницу:

Для красивого открытия изображений во всплывающем окне, Вы можете использовать любой подходящий JavaScript. Например FancyBox.

4.3.6. Добавление списка файлов для скачивания

Еще одной растространненной задачей является добавление на страницу списка файлов для скачивания. Используйте функцию cot_filesDownloads() в своем шаблоне(«page.tpl»):



    {PHP.L.files_downloads}
    {PAGE_ID|cot_filesDownloads('page',$this)}

Стандартный блок выглядит так:

4.4 Экстраполя

Как и большинство модулей и плагинов Cotonti, модуль файлов позволяет добавлять и использовать экстраполя для файлов и папкок (альбомов). Экстраполя типа "Файл" не поддерживаются. Для редактирования их значений через Ajax элементы формы экстраполей должны иметь класс «file-edit». Просто добавте атрибут «class» со значением «file-edit» в панеле управления - на странице редактирования экстраполей в поле «HTML-код поля» .

4.5 Расширенные возможности

Для решения большинства задач по выводу вложений этого достаточно. Хотите большего? Тогда этот раздел для Вас.

4.5.1 Вызов функций (виджетов) из TPL шаблонов и их параметры.

Прикрепление файлов не ограничивается только модулем страниц и стандартными шаблонами. Вы легко можете настроить прикрепление файлов и к другим объектам системы и настроить соответствующие им шаблоны. Ниже будет описанино какие функции плагин предоставляет для использования в шаблонах и какие параметры им нужно передавать.

cot_filesDisplay

/**
 * Renders attached items on page
 * @param string $source Target module/plugin code
 * @param int|int[] $item Target item id
 * @param string $field
 * @param string $tpl Template code
 * @param string $type Attachment type filter: 'files', 'images'. By default includes all attachments.
 * @param int $limit
 * @param string $order
 * @return string Rendered output
 */
function cot_filesDisplay(
    string $source,
    $item,
    string $field = '',
    string $tpl = 'files.display',
    string $type = 'all',
    $limit = 0,
    string $order = ''
): string

Этот виджет используется для отображения прикрепленых к объекту файлов. Он может выводить как все файлы, так отдельно изображения, отдельно файлы, не являющиеся изображениями. Упомянутые выше функции cot_filesGallery и cot_filesDownloads по сути являются «обертками» для этой функции. Принимаемые параметры схожи с функциями, рассмотренными выше:

$source - определяет тип содержимого к которому прикреплены изображения. Аналогично соотвествующему параметру cot_filesFilebox() и cot_filesWidget(). Например 'page', 'forums', 'comments', и т.п...
$item - ID объекта, файлы которого мы выводим.
$field - имя поля.
$tpl - Код шаблона, содержащего html код виджета.
$type - тип. Этот параметр используется при необходимости вывода только изображений или только файлов, не не являющихся изображениями.

Стандартные шаблоны Вы можете найти в папке «modules/files/tpl». Используйте их как образец.
«files.display.tpl» и «files.downloads.tpl» представляют собой разные стили отображения файлов.
«files.gallery.tpl» - шаблон галереи.
«files.bootstrap-carousel_gallery.tpl» - Слайдшоу - карусель на базе bootstrap.

Обратите внимание, на то, что параметр $tpl функции принимает имя файла без расширения. (.tpl на конце указывать не нужно)

Пример ниже отобразит все файлы, прикрепленые к посту на форуме. Код следует разместить в шаблоне «forums.posts.tpl» в блоке FORUMS_POSTS_ROW:

{FORUMS_POSTS_ROW_ID|cot_filesDisplay('forums', $this)}

cot_filesCount

/**
 * Returns number of attachments for a specific item.
 * @param string $source Target module/plugin code
 * @param int $sourceId Target item id
 * @param string $sourceField Target item field
 * @param string $type Attachment type filter: 'files', 'images'. By default includes all attachments.
 * @return int Number of attachments
 */
function cot_filesCount($source, $sourceId, $sourceField = '', $type = 'all')

Возвращает количество файлов, присоединенных к объекту. Параметры аналогичны cot_filesDisplay(), за исключением того, что параметр $field может принимать значение '_all_'. В этом случае фукнция вернет общее количество файлов, прикрепленных к объекту (ко всем «полям»)

Например, выводим список файлов, прикрепленных к посту на форуме только если хотя бы один файл был прикреплен:



    {FORUMS_POSTS_ROW_ID|cot_filesGallery('forums', $this)}

cot_filesGallery

/**
 * Renders images only as a gallery.
 * @param string $source Target module/plugin code
 * @param int|int[] $item Target item id
 * @param string $field
 * @param string $tpl Template code
 * @param int $limit
 * @param string $order
 * @return string Rendered output
 */
function cot_filesGallery(string $source, $item, string $field = '', string $tpl = 'files.gallery', $limit = 0, string $order = ''): string

Функция обертка для cot_filesDisplay() с параметром $type установленном в 'images' и c кодом шаблона по умолчанию 'files.gallery'.

cot_filesDownloads

/**
 * Renders files only as downloads block.
 * @param string $source Target module/plugin code
 * @param int|int[] $item Target item id
 * @param string $field
 * @param string $tpl Template code
 * @param int $limit
 * @param string $order
 * @return string Rendered output
 */
function cot_filesDownloads(string $source, $item, string $field = '', string $tpl = 'files.downloads', $limit = 0, string $order = ''): string

Функция обертка для cot_filesDisplay() с параметром $type установленном в 'files' и c кодом шаблона по умолчанию 'files.downloads'.

Обычно используется для организации блоков файлов для скачивания.

cot_filesThumbnailUrl

/**
 * Returns file's thumbnail url. Generates the thumbnail first if it does not exist.
 * Can be used in template files as callback
 * @param File|int $id File ID or instance of File.
 * @param int|string $width Thumbnail width absolute in pixels (int) or percent (string: '10%')
 * @param int|string $height Thumbnail height absolute in pixels (int) or percent (string: '10%')
 * @param string $frame Framing mode: one of \image\Image::THUMBNAIL_XXX constants (for backwards compatibility 'auto' and 'crop' also supported)
 * @param bool $watermark - set watermark if Cot::$cfg['files']['thumb_watermark'] not empty?
 * @param bool $lastMod Include last file modification time as GET parameter
 * @return string Thumbnail path on success or null on error
 *
 * @see ThumbnailService::thumbnail()
 */
function cot_filesThumbnailUrl($id, $width = 0, $height = 0, string $frame = '', $watermark = true, $lastMod = null): string

Генерирует миниатюру для изображения и возвращает ее URL.

Принимаемые параметры:

$id - id файла или экземпляр класса\cot\modules\files\models\File
$width - ширина миниатюры
$height - высота миниатюры
$frame - режим кадрирования. Может принимать следующие значения
- 'width' заполняет миниатюру по ширине и сохраняет соотношение сторон.
- 'height' заполняет миниатюру по высоте и сохраняет соотношение сторон.
- 'inset' (по-умолчанию) сохраняет соотношение сторон уменьшая изображение таком образом, чтобы его размеры не превысили заданых.
- 'outbound' уменьшает изображение сохраняя соотношение сторон и обрезает изображение так, чтобы оно полностью заполнило указаные размеры. На примере галереи выше использован именно этот режим.

cot_filesGet

/**
 * Fetches a single attachment object for a given item.
 * @param string $source Target module/plugin code.
 * @param int $sourceId Target item id.
 * @param string $sourceField Target item field
 * @param string $column Empty string to return full row, one of the following to return a single value: 'id',
 *                              'user_id', 'path', 'file_name', 'original_name', 'ext', 'is_img', 'size', 'title', 'downloads_count'
 * @param string $number Attachment number within item, or one of these values: 'first', 'rand' or 'last'. Defines which image is selected.
 * @return File|int|string|null Scalar column value, File object or NULL if no attachments found.
 */
function cot_filesGet($source, $sourceId, $sourceField = '', $column = '', $number = 'first')

Служит для получения информации об одном файле, прикрепленном к объекту. Очень часто эта функция используется для вывода обложки страницы на списках страниц.

Параметры:

$source - определяет тип содержимого к которому прикреплены изображения. Аналогично соотвествующему параметру cot_filesDisplay().
$item - ID объекта.
$field - аналогично соотвествующему параметру cot_filesDisplay().
$column - если не передано, то возвращает экземпляр класса \cot\modules\files\models\File, иначе вернет значение указанного поля этого объекта.
$number - Порядковый номер вложения или 'first' для вывода первого файла, 'rand' - для случайного или 'last' для последнего.

Пример вывода обложки страницы в шаблоне page.list.tpl:

Как видите, результат работы этой функции можно передать в cot_filesThumbnailUrl().

4.5.2 BB-коды для вставки в контент

Изображения и их миниатюры и даже пупбличные папки из файлового хранилища могут быть вставлены прямо в текст страницы, комментария, поста на форуме и т.п.

Для этого необходимо знать id файла (или папки). Синтаксис параметров bb-кода схож со строкуой URL запроса. Доступные bb-коды:

[files_thumb] - вставляет только миниатюру в тег .
[files_image] - вставляет a кликабельную миниатюру с ссылкой на большое изображение.
[pfs_gallery] - вставляет галерею, генереруемую из публичной папки файлового хранилища.

Пример использования:

[ files_thumb?id=15]
[ files_image?id=11&width=320&height=240&alt=Picture description&class=foo]
[ pfs_gallery?f=5&tpl=files.bootstrap-carousel_gallery]

Эти bb-коды работают независимо от парсера, включая HTML и Markdown. Если Вы хотите их отключить, просто приостановите выполнение части «parser» этого модуля в панели управления «Управление сайтом / Расширения / Files».

История версий

v. 2.0.1

Cовместимость с Cotonti 0.9.25

v. 2.0.0

Использование Image bundle из библиотеки Cotonti Lib для обработки изображений.
Использование File System из библиотеки Cotonti Lib и Flysystem для хранения файлов и операций с ними.
Обфускация имен файлов.
Уменьшение загружаемых изображений в браузере, если возможно.
Рефакторинг кода. Функции переименованы по шаблону cot_filesFunctionName().

v. 1.0.8

Добавлена поддержка удаления пользователей, страниц и постов на форуме в корзину. При удалении этих элементов файлы не удаляются и после восстановления элемента из корзины, файлы остаются привязными к этим элементам. При удалении элементов из корзины, связанные файлы тоже удаляются.

v 1.0.7

Добавлена поддержка графических форматов: avif, bmp, gd2, gd, tga, tpic, wbmp, webp, xbm
jQuery File Upload обновлен до версии 10.32.0
Совместимость с PHP 8.1
Исправлены некоторые ошибки

GitHub: https://github.com/Alex300/files

Cotonti - Рассылки

Mon, 20 Jul 2015 10:34:00 +0300

Модуль рассылок для CMF Cotonti.

Тип: Модуль
Версия: 1.0
Совместимость: Siena

GitHub: https://github.com/Alex300/subscribe

Это расширение позволяет организовать рассылки на Вашем сайте под управлением Cotonti. Рассылки можно создать вручную, либо организовать автоматические подписки на страницах сайта. Это могут быть последние новости, новинки Вашего интернет магазина и т.п.

Системные требования и ограничения:

Наличие на Вашем сайте установленной библиотеки cotonti-lib версии 1.5 (именно 1.5 а не 2)
В качестве шаблонизатора используется View
Административная часть модуля сделана под панель управления Cpanel. Если Вы используете стандартную панель администратора Cotonti, Вам нужно переопределить соотвествующие шаблоны.

Установка:
- Скопировать модуль на сервер или склонировать репозиторий в папку modules/subscribe
- Установить модуль из панели администратора
- В папке inc установить права на запись на файл 'queue.txt'
- Создать рассылки в панели администратора
- Создать задание для cron для отправки писем (см. ниже)

Возможности:
   - Создание различных рассылок на Вашем сайте
   - Ручное и автоматическое создание контента рассылки
   - Ручное добавление подписчиков администратором
   - Форма подписки на любую рассылку на Вашем сайте для пользователей
   - Использование очереди отправки, чтобы распределить нагрузку на сервер при выполнении рассылки
   - Подтверждение электронного адреса для незарегистрированных пользователей

Создание рассылки:
Рассылки создаются в панели управления. Вы можете настроить получение контента по некоторому URL-адресу (если какой то из установленных у Вас модулей предоставляет соответствующий функционал) или добавить контент вручную.

Также Вы можете настроить шаблон для каждой рассылки. Это дает большие возможности по формированию контента рассылки. В шаблонах Вы можете использовать любые виджеты, например pagelist.

Шаблоны именуются по такому принципу: subscribe.mail..php, где alias - это алиас, назначенный данной рассылке.

Пример фрагмента шаблона ежедневной рассылки новостей:

$begin = strtotime(date('Y-m-d 00:00:01', cot::$sys['now'])); // Начало суток
$condition = "page_state=0 AND page_begin >= {$begin} AND (page_expire = 0 OR page_expire > ".
    cot::$sys['now'].")"

?>

    
        /themes/your-theme/img/logo-small.png">
        Новости от 
    
    
        
    
    text;?>

В этом примере используется виджет плагина pagelist для формирования списка новостей за день. А ниже выводится текст, добавленный в админке.

Создание заданий Cron:
Рассылки могут рассылаться пользователям как за "один раз" так и при помощи очереди. Последний вариант предпочтительнее т.к. при большом количестве получателей позволяет распределить нагрузку на сервер в течение дня.

Указывая в настройках модуля количество писем, отправляемых из очереди за один раз ставьте такое значение, чтобы в конце суток у Вас очередь оказалась пустой. Иначе письма в очереди станут накапливаться.

Независимо от выбранного способа отправки Вам необходимо в cron добавить следующее задание:

# Выполняется в 0:10, 2:10, 4:10 и т. д.
10 */2 * * *  php /path/to/your/site/cli.php --a subscribe.main.run > /path/to/your/site/log/subscribe.log

Пути к файлам следует изменить на нужные.

Сделать это можно из консоли, выполнив следующую команду:

crontab -e

Если на Вашем хостинге нет доступа к командной строке, то используйте те инструменты, которые предоставляет Ваш хостер.

Для запуска обработчика очереди, добавьте в cron задание:

# Выполняется каждые 30 минут
*/30 * * * *  php /path/to/your/site/cli.php --a subscribe.main.runQueue > /path/to/your/site/log/subscribeQueue.log

Разное:

http://<ваш_домен>/subscribe - активные периодические рассылки. Авторизованные пользователи могут на них подписаться

cot_url('subscribe', array('m'=>'user')) - мои подписки пользователя
cot_url('subscribe', array('m'=>'user', 'uid'=1)) - подписки пользователя с id=1

GitHub: https://github.com/Alex300/subscribe

Cotonti - Banners

Wed, 08 Jul 2015 23:09:00 +0300

Модуль предназначен для показа рекламных баннеров на сайте (т.н. "баннерокрутилка").

тип: модуль
Версия плагина: 2.0.1
Совместимость: Siena

GitHub: https://github.com/Alex300/brs

Системные требования и ограничения:

Наличие на Вашем сайте установленной библиотеки Cotonti Lib версии 2.0.x
Административная часть плагина расчитана на альтернативную тему панели управления cpanel.
В качестве шаблонизатора используется View

Описание:

Баннеры разделяются по категориям и в каждую рекламную позицию на сайте можно вывести баннеры из одной или нескольких категорий. Вывод баннеров, ротация, осуществляется по порядку или случайным образом.
Для каждого баннера ведется статистика показов и кликов. Возможно ведение почасовой статистики, но это вызовет дополнительную нагрузку на сервер.

Поддерживаются изображения и флеш. Так же есть возможность установки произвольного кода баннера, например со сторонней рекламной системы.

Для удобства ведения рекламных кампаний, баннеры можно разбивать по клиентам. Это позволяет получать статистику показов и кликов по баннеру для каждого клиента.

Возможности:
- отображение и автоматическая ротация баннеров на вашем сайте
- упорядоченная или случайная ротация баннеров
- поддерживаемые форматы: jpeg, png, gif, bmp и swf
- возможность установки произвольного кода баннера
- неограниченное количество категорий (баннерных позиций)
- неограниченное количество баннеров в категрии и в целом
- статистика показов и кликов
- почасовая статистика показов и кликов
- отчет о показах и кликах с фильтрами по периоду, категориям и клиентам
- привязка баннеров к клиентам

Установка:
- Скопировать модуль на сервер в папку modules/brs
- В папке datas cоздать папку brs и установить на нее права на запись
- Установить планин в панели управления
- Создать нужные категории и баннеры
- В нужное место файла шаблона добавить вызов виджета: (параметры см. ниже)

Параметры виджета:
Виджет вызывается со следующими параметрами

brs_controller_Widget::banner($cat, $cnt = 1, $tpl = 'brs.banner', $order = 'order', $client = false, $subcats = false)

где:

$cat - категория баннеров или список категорий, разделенный символом ';'

Остальные параметры не обязательные

$cnt - количество выводимых баннеров. При выводе нескольких баннеров подряд, следует использовать этот параметр вместо нескольких вывозовов этой функции, т.к. каждый отдельный вывозов совершает обращения в базе данных
$tpl = tpl - файл
$order - порядок показа. Допустимые значения 'order' - по порядку, 'rand' - случайно
$client - данный параметр пока не используется
$subcats - выводить баннеры из вложенных категорий

Однако, в отличие от шаблонизатора View, встроенный шаблонизатор CoTemplate не умеет работать с объектами (как ни странно). Для использования в tpl-шаблонах пользуйтесь call-back функцией:

banner_widget($cat, $cnt = 1, $tpl = 'banners', $order = 'order', $client = false, $subcats = false)

Она является оберткой для brs_controller_Widget::banner.

История изменений:

Версия v2.0.1

Совместимость с Cotonti Lib v2.0.

Версия v2.0.0

Расширение теперь полноценный модуль. Раньше оно было плагином.
Переход на Cotonti Lib. Это дало унификацию API и повышение производительности.
Изменен код расширения и название папки на сервере. ADBlocker'ы не любили название banners :)

Обратите внимание! Автоматическое обновление плагина (версии 1) до модуля (версии 2) невозможно.

GitHub: https://github.com/Alex300/brs

Версия 1: https://github.com/Alex300/banners

Cotonti - Доска объявлений

Wed, 17 Jun 2015 22:34:00 +0300

Модуль доски объявлений для CMF Cotonti.

Тип: Модуль
Версия: 3.0.3
Совместимость: Siena

GitHub: https://github.com/Alex300/advboard

Это расширение позволяет организовать доску объявлений на Вашем сайте под управлением Cotonti. Оно является полноценным модулем со своей таблицей объявлений в БД с поддержкой экстраполей и своей структурой категорий.

Системные требования и ограничения:

Наличие на Вашем сайте установленной библиотеки Cotonti Lib версии 2.0.1 - 2.0.3
В качестве шаблонизатора используется View

Установка:
- Скопировать модуль на сервер или склонировать репозиторий в папку modules/advboard
- Установить модуль из панели администратора
- В папке inc установить права на запись на файл 'send.txt'

Возможности:
   - подача объявлений на сайт
   - опциональное автоутверждение объявлений или премодерация для каждой категории
   - уведомление пользователя о новых комментариях к своему объявлению на e-email
   - уведомление пользователя об истечении срока публикации объявления на свой e-email
   - редактирование пользователем своих объявлений
   - незарегистрированные пользователи могут редактировать объявление в пределах сессии
   - "Мои объявления" в профиле пользователя
   - Список объявлений пользователя на странице его профиля
   - "Прилепленные" объявления выводятся сверху списка
   - Вывод списка последних объявлений
   - Виджет объявлений
   - Сравнение объявлений

Права пользователей:
Права пользователей зависят от прав на категории доски объявлений.
Дополнительные права:
1 - загрузка файлов
2 - автоутверждение объявлений.

Загрузка файлов используется в шаблоне редактирования объявления. Если пользователь обладает этим правом, то вы можете отобразить для него виджет загрузки модуля файлов.

Если пользователь не обладает правом 2 (Автоутверждение объявлений), то его объявления попадают на модерацию и без подверждения администратора не будут показаны другим пользователям.

Виджет объявлений:
Для вывода списка в произвольное место используется виджет advboard_controller_Widget::widget(). Объявлен в файле: modules/advboard/controller/Widget.php

Сам виджет имеет вид:

public static function widget($condition = array(), $tpl = 'advboard.widget.list', $items = 0, $order = '', $onlyActive = true, $pagination = 'pld', $params = array())

где:

$condition - SQL запрос для запроса объявлений
$tpl - файл шаблона для вывода
$items - количество элементов для вывода
$order - порядок сортировки по правилам SQL
$onlyActive - Выводить только активные объявления
$pagination - параметр для постраничной навигации, если будет использоваться

Обратите внимание на то что в качестве шаблонизатора виджет использует View из Cotonti Lib а не coTemplate.

Подробнее понять его работу можно посмотрев код виджета.

Если Вы хотите вывести список в tpl-файле, то CoTemplate, в отличии от View не умеет работать с класами. В этом случае используйте виджет-обертку для этого метода advboard_widget(). см. modules/advboard/inc/advboard.functions.php

Письма с уведомлениями:
Если в настройках включено уведомление администратора о новых объявлениях, то он получает уведомления о всех добавленых или измененных объявлениях, иначе только если объявление попало на модерацию.

Вы можете создавать шаблоны уведомлений именуя файлы следующим образом: advboard.notify_admin_new...php

Разное:

http://<ваш_домен>/advboard/unvalidated - объявления на модерации
http://<ваш_домен>/advboard/saved-drafts - неопубликованные (черновики)

Мои объявления: cot_url('advboard', array('m' => 'user'))
Объявления пользователя: cot_url('advboard', array('m' => 'user', 'uid' => $user_id))
Количество объявлений пользователя: cot_user_ads_count($user_id)

RSS лента: cot_url('advboard', 'm=rss&c=<код_категории>')

Если пользователю создать екстраполя phone и city (city_name), то он может использовать их, чтобы не заполнять в объявлениях одну и ту же информацию.

История изменений:

Версия v.3.0.3

Исправление ошибок в работе виджета объявлений

Версия v.3.0.2

Настраиваемый заголовок для главной страницы доски объявлений и первого элемента хлебных крошек.
Улучшен виджет сравнения
Совместимость с Cotonti Lib v2.0.1

Версия v.3.0.1

Совместимость с Cotonti Lib v2.0.0

Версия v.3.0.0

Расширение теперь полноценный модуль. Раньше оно было плагином.
Добавлен функционал сравнения объявлений.
Добавлен виджет для вывода обяъвлений в любых шаблонах сайта.

Обратите внимание! Автоматическое обновление плагина (версии 2) до модуля (версии 3) невозможно.

Версия v.2.0.0

Совместимость с Cotoni Siena.

GitHub: https://github.com/Alex300/advboard

Плагин версии 2

Cotonti - Dictionary.

Tue, 16 Jun 2015 23:15:00 +0300

Плагин для CMF Cotonti.

Плагин словарей и номенклатуры для Cotonti Siena.

тип: плагин
Версия: 1.0.1
Совместимость: Siena

GitHub: https://github.com/Alex300/dictionary

Системные требования и ограничения:

Наличие на Вашем сайте установленной библиотеки Cotonti Lib версии 2.0.x
Административная часть плагина расчитана на альтернативную тему панели управления cpanel.

Установка:
- Скопировать плагин на сервер в папку plugins/dictionary
- Установить плагин из панели администратора

Плагин позволяет организовать номенклатуру на сайте под управлением Cotonti. А именно - создать словари с наборами 'Ключ' => 'Значение'. Т.е. каждому слову в словаре сопрставляется уникальный ID, которые можно использовать в других расширениях. Например это могут быть марки или модели авто, типы товаров, должности сотрудников и т.п.

Словари можно использовать для хранения вариантов выбора для экстраполей типа «select».

Словари можно использовать как связанные данные для других моделей.

Этот пример заполнит варианты выбора экстраполей значениями из словарей:

$conf = array(
	array(
		'location' => cot::$db->advert,
		'field' => 'brand',
		'dictionary' => 2,
		'condition' => "id IN (1,2,3)",
	),
	array(
		'location' => cot::$db->advert,
		'field' => 'model',
		'dictionary' => 3,
		'parent' => cot_import_buffered('brand', $advert->brand, 0),
	),
);

dic_loadExtraFieldData($conf);

параметры конфигурации:

- location и field - таблица и экстраполе соотвественно
- dictionary - id словаря, от куда брать значения
- condition (необязательно) - условия выборки значений. Если не указано то выбираются все значения указанного словаря.
- parent (необязательно) - значение родительского словаря.

Плагин может быть полезен прежде всего разработчикам. Вы в своих таблицах можете хранить id значений словарей, получая сами значения только при необходимости. Это позволяет избежать ошибок при многократном написании самих значений. А исправление внесенное в словарь сразу отразится на всех связанных данных. Также возможно организовать поиск по таким полям.
Напрмер: выбрать все модели автомобилей марки BMW.

Программно получить список "ключ" => "значение" метод dictionary_model_Value::keyValPairs(), например:

dictionary_model_Value::keyValPairs(array(array('dictionary', 3)));

выберет все значения для словаря с id=3.

Родительский словарь

Словарь может иметь родителя. Например модель автомобиля - марку, а город относится к определенному региону. dic_loadExtraFieldData() организует элементы select так, что после выбора значения родительского словаря (например произволителя авто) пользвателю будет предложен выбор соотвествующих значений словаря - потомка (напрмер: марки авто этого производителя)

Упрощенным и частным случаем этого плагина является плагин Region-City.

История изменений:

Версия v1.0.1

Совместимость с Cotonti Lib v2.0.

Cotonti - cPanel.

Fri, 02 Jan 2015 17:35:00 +0300

Современная и удобная панель управления для CMF Cotonti.

тип: тема и модуль
Версия модуля: 1.0.0
Совместимость: Siena

GitHub: https://github.com/Alex300/cotonti-cpanel

Панель управления, использующая фреймворк Bootstrap3 в качестве каркаса для верстки и Font Awesome для иконок. В состав входит модуль cpanel, который расшряет возможности стандартной панели администратора Cotonti.

Установка:

- Скопировать тему cpanel на сервер в папку themes/admin
- Скопировать модуль cpanel на сервер в папку modules
- Скачать и установить Bootstrap и Font Awesome в папку lib Вашего сайта.
- Установить модуль из панели администратора
- В файле datas/config.php установить $cfg['admintheme'] = 'cpanel';

Для разработчиков:

Вы можете в полной мере использовать возможности разметки, которые предоставляет Bootstrap.

Конетент Вашего расширения будет выводиться в панель по-умолчанию. Вы можете отключить такое поведение при необходимости.

Добавление пунктов меню в панели управления:

Модули и плагины могут добавлять свои пункты в меню панели управления.

Для этого необходимо создать файл расшиения с хуком header.tags который внесет нужные изменения в массивы элементов меню:

cpanel::$menu['top'] - Верхнее меню
cpanel::$menu['side'] - Боковое меню
cpanel::$menu['user'] - Меню пользователя

cpanel::$useDefaultPanel = true; - выводить панель-по умолчанию при выводе контента
cpanel::$panelTitle; - свое название для панели по-умолчанию

Пример кода:

if (!COT_AJAX && defined('COT_ADMIN') && $cfg['admintheme'] == 'cpanel') {
    cpanel::$menu['side'][] = [
        'title' => 'My Cool Module',
        'url' => cot_url('admin', ['m' => 'my_cool_module']),
        'icon_class' => 'fa fa-times-circle',
    ];
}

История изменений:

Версия v.1.0.0

Совместимость с Cotonti 0.9.25

Версия v.0.0.5-0.0.6

Совместимость с Cotonti Siena 0.9.22-0.9.23

Версия v.0.0.4

Совместимость с PHP 8.1

Версия v.0.0.3

Панель «по-умолчанию»
Улучшено левое меню.

Версия v.0.0.2

Добавлены еще шаблоны «коробочных» расширений Cotonti.
Загрузка JS и CSS-файлов доверена системному классу Resources.

Скриншоты:

Cotonti - Работа.

Sat, 25 Oct 2014 11:59:00 +0300

Модуль поиска работы и подбора персонала для Cotonti.

тип: модуль
Версия модуля: 1.0.1
Совместимость: Siena

GitHub: https://github.com/Alex300/personal

Модуль позовляет пользователям Вашего сайта на Cotonti создавать и размещать резюме, вакансии и информацию компаниях работодателях.

Системные требования и ограничения:

PHP версии 5.3 и выше. Работа с PHP версии 5.2.х и ниже невозможна.
Наличие на Вашем сайте установленной библиотеки Cotonti Lib версии 2.0.x
Наличие на Вашем сайте установленного плагина Region-City ajax selector
Наличие в папке /lib Java Script библиотеки Select2 (для поиска города по первым буквам)

Установка:
- Скопировать папку personal на сервер в папку modules
- Установить модуль из панели администратора
- Создать категории для вакансий/резюме.
- Установить Select2 в папку /lib. Структура папок должна получиться следующая

lib
    select2
        css
        js

Рекомендации:
- Вы можете использовать модуль Файлов чтобы организовать вложения к вакансиям и резюме.

Для вакансий используйте параметр source: "personal_vacancy", а для резюме - "personal_resume". В этом случае вложения будут автоматически привязываться к вновь создаваемым объектам и корректно удаляться при их удалении.

История изменений:

Версия v.1.0.1

Совместимость с MySQL 5.7 и Cotonti Lib 2.0.

View. PHP-шаблонизатор.

Sat, 13 Sep 2014 23:21:00 +0300

Исторически сложилось так, что Cotonti использует шаблонизатор CoTemplate, что накладывает значительные ограничения на возможности самих шаблонов, даже несмотря на то, что за последние годы он стал намного удобнее.

Но мы знаем, что PHP сконструирован специально для ведения Web-разработок и его код может внедряться непосредственно в HTML.
PHP — сам по себе является не только очень мощьным языком программирования, но и самодостаточным шаблонизатором, позволяющим делать качественные шаблоны без ущерба для логики приложения.

Такой стиль шаблонизации на PHP называют «pure-шаблонизация», т.е. чистая шаблонизация, основанная на возможностях самого PHP.

Класс View позволяет использовать шаблоны на чистом PHP.

Преимущества:

- Чистый PHP будет работать быстрее шаблонизаторов (интрепретаторов), написанных на PHP, т.к. нет программной "прослойки" между PHP и шаблоном, выполнение которой, как ни крути, а требует рессурсов. Хотя, многие современные шаблонизаторы компилируют шаблоны в PHP код.

- PHP и есть шаблонизатор и в шаблоне доступны все его возможности.

- Не нужно изучать дополнительный синтаксис. Знания HTML и шести - десяти конструкций на PHP вполне достаточно для верстки шаблона почти любой сложности.

Недостатки:

- Кто то считает, что «ужасный синтаксис». По-моему - это весьма субъективно и зависит от личных предпочтений. В моделях и контроллерах он уже не выглядит настолько ужасным )

- Слишком много лишнего текста в шаблонах. Тоже зависит от личных предпочтений и субъективно.

Итак к делу.

По существу применение View состоит из двух шагов:

1. Ваш скрипт контроллера создает экземпляр View и объявляет переменные этого экземпляра.

2. Контроллер приказывает View воспроизвести данный вид используя шаблон.

Скрипт контроллера

В качестве простого примера предположим, что ваш контроллер имеет список данных по книгам, который нужно вывести пользователю. Скрипт контроллера может выглядеть примерно так:

// Для наглядности, у нас есть массив с данными о книгах
$data = array(
	array(
	    'author' => 'Hernando de Soto',
	    'title' => 'The Mystery of Capitalism'
	),
	array(
	    'author' => 'Henry Hazlitt',
	    'title' => 'Economics in One Lesson'
	),
	array(
	    'author' => 'Milton Friedman',
	    'title' => 'Free to Choose'
	)
);

// теперь присваиваем данные по книгам экземпляру View
$view = new View();
$view->books = $data;

// и выполняем скрипт вида "booklist.php"
echo $view->render('library.booklist.php');

Скрипт шаблона:

Теперь нам нужен сопутствующий скрипт шаблона "library.booklist.php". Это такой же скрипт PHP, как и остальные, за одним исключением: он выполняется в области видимости экземпляра View, это означает, что $this ссылается на экземпляр View. Переменные, присваиваемые в контроллере для скрипта вида, являются открытыми свойствами экземпляра View. Таким образом, базовый скрипт вида может выглядеть следующим образом:

Список книг
books): ?>


books as $key => $val): ?>
    
    
        Author
        Title
    

    
        
        
    
    





Нет книг для отображения.

Класс View также подерживает присваивание переменных в стиле CoTemplate:

$view->assign(array(
    'PAGE_TITLE'  =>  $title,
    'BREADCRUMBS' =>  cot_breadcrumbs($crumbs, cot::$cfg['homebreadcrumb']),
));

что аналогично:

$view->PAGE_TITLE = $title;
$view->BREADCRUMBS = cot_breadcrumbs($crumbs, cot::$cfg['homebreadcrumb']);

Основные методы класса View:

render($viewFile, $type = 'module', $admin = null, $return = true)

Рендерит HTML код из шаблона и полученных данных.Принимает следующие параметры:

$viewFile - имя файла шаблона. Если не указано расширение или оно не входит в свойство класса $_extensions, будет использовано ".php".
$type - тип расширения. Может быть 'plug', 'module' or 'core'
$admin - использовать файл admin-темы, если возможно. По умолчанию эту опцию метод пытается определить исходя из параметра $viewFile
$return - Вернуть готовый HTML-код в виде строки (если TRUE) или выполнить require($viewFile)

Файл шаблона ищется по тем же правилам, что и при использовании функции cot_tplfile() для CoTemplate.

addScriptPath($path, $prepend = true)

Добавить дополнительный путь для поиска шаблонов.

$path - Путь к папке с шаблонами.
$prepend - Поместить путь в начало стека.

scriptFile($base, $type = 'module', $admin = null)

Ищет и возвращает полый путь к файлу шаблона или false, если шаблон не найден. Параметры аналогичны методу render();

SOM. (Simple Object Manipulation)

Tue, 13 May 2014 07:42:00 +0300

Общие сведения

SOM (Simple Object Manipulation) - это простая ORM, позволяющая работать с записями в базе данных посредством моделей, объектов, обладающих определенным набором методов, свойств и связями с другими моделями.

SOM является логическим продолжением ORM из cot-factory и представляет собой усовершенствованную и доработанную ORM из упомянутой библиотеки. Спасибо Gert Hengeveld и Владимиру Сибирову (trastmaster) за их труд над cot-factory.

Модели данных создаются в рамках паттерна MVC и соответствуют его концепции. Модели инкапсулируют основные операции с базой данных и позволяют абстрагироваться от непосредственной работы с ней и сосредоточится на программировании.

Требования

Для правильной работы необходим php не ниже версии 5.3

Использование нескольких соединений с бд

Иногда бывает необходимо использовать несколько соединений с базой данных. Например когда Вы используете данные, которые хранятся в разных БД или пишите конвертер для переноса данных из одной БД в другую. SOM предоставляет Вам такую возможность.

Для этого в файл datas/config.php вашего сайта добавте описание нужных соединений:

$cfg['db_connect_name'] = array(
      'adapter' => 'mysql',   // 'pgsql' or 'mongo'
      'host' => '127.0.0.1',
      'port' => null,
      'username' => '12345',
      'password' => '6789',
      'dbname' => 'my_data_base',
 );

Поддерживаются базы данных MySql и PostgreSQL. Mongo - эксперементально.

Чтобы установить соединение вызовите фабричный метод:

$db_my_conn = Som::getAdapter('db_connect_name');

который вернет объект Som_Model_Mapper нужного типа. После этого можно отправлять ему запросы обычным образом:

$db_my_conn->query("SELECT * FROM `cot_some_table` ORDER BY id ASC");

Также Вы можете передавать имена соединений моделям при инициализации, если необходимо использовать соединения, отличные от системного в Cotonti.

Соединения кешируются на период выполнения. Это значит, что Вы можете вызывать метод Som::getAdapter с одним и тем же параметром столько - сколько Вам нужно. Объект соединения с БД не будет создаваться каждый раз заново, а будет возвращаться ссылка на один раз созданный объект.

Создание моделей

Конкретная модель создается классом, который наследуется от класса Som_Model_Abstract. Соотвественно, он насследует все его методы. В создаваемом классе модели обязательно должны быть определены следующие свойства:

protected static $_db;
protected static $_tbname = 'katalogshop_sale';

и опционально

protected static $_primary_key = 'prod_id';

$_db хранит ссылку на объект базы данных
$_tbname - имя таблицы в БД. Указывается явно при объявлении.
$_primary_key - название поля - первичный ключ таблицы. Если не указано, то используется поле 'id'.

В конце файла класса модели необходимо вызвать статический метод этого класса _init(). По умолчанию будет выполнен соотвествующий метод родительского класса. Это т.н. «статический конструктор», который выполняет начальную инициализацию модели, заполняет свойства $_db и загружает экстраполя.

пример модели расписания для группы ВУЗА:

_data['id']);
    }

    /**
     * @return bool
     */
    public function delete(){

        // Remove all files and images
        $files = files_model_File::find(array(
            array('file_source', 'sgrp_schedule'),
            array('file_item', $this->_data['id'])
        ));
        if(!empty($files)){
            foreach($files as $fileRow){
                $fileRow->delete();
            }
        }

         return parent::delete();
    }

    public static function fieldList() {
        return array(
            'id'  =>
                array(
                    'type'    => 'bigint',
                    'primary' => true,
                    'description' => 'id'
                ),
            'title'  =>
                array(
                    'type'      => 'varchar',
                    'length'    => '255',
                    'description' => 'Заголовок'
                ),
            'description'  =>
                array(
                    'type'      => 'varchar',
                    'nullable'  => true,
                    'default'   => '',
                    'length'    => '255',
                    'description' => 'Краткое описание'
                ),
            'text' =>
                array(
                    'type'      => 'text',
                    'nullable'  => true,
                    'default'   => '',
                    'description' => 'Текст'
                ),
            'begin'  =>
                array(
                    'type'      => 'datetime',
                    'default'   => date('Y-m-d H:i:s', cot::$sys['now']),
                    'description' => 'Дата начала'
                ),
            'end'  =>
                array(
                    'type'      => 'datetime',
                    'description' => 'Дата окончания'
                ),
            'created'  =>
                array(
                    'type'      => 'datetime',
                    'safe'      => true,
                    'description' => 'Дата создания'
                ),
            'created_by'  =>
                array(
                    'type'      => 'bigint',
                    'safe'      => true,
                    'description' => 'Кем создано'
                ),
            'updated'  =>
                array(
                    'type'      => 'datetime',
                    'safe'      => true,
                    'description' => 'Дата обновления'
                ),
            'updated_by'  =>
                array(
                    'type'      => 'bigint',
                    'safe'      => true,
                    'description' => 'Кем обновлено'
                ),
            'sgroup' =>
                array(
                    'type' => 'link',
                    'description' => 'Группа Вуза',
                    'link' =>
                        array(
                            'model'    => 'vuz_model_Group',
                            'relation' => Som::TO_ONE_NULL,
                            'label' => 'sgrp_title',
                        ),
                ),
        );
    }

    // === Методы для работы с шаблонами ===
    /**
     * Returns all Group tags for coTemplate
     *
     * @param vuz_model_Schedule|int $item vuz_model_Vuz object or ID
     * @param string $tagPrefix Prefix for tags
     * @param array $urlParams
     * @param int $textlength
     * @param bool $cacheitem Cache tags
     * @return array|void
     */
    public static function generateTags($item, $tagPrefix = '', $urlParams = array(), $textlength = 500, $cacheitem = true){

        static $extp_first = null, $extp_main = null;
        static $cacheArr = array();

        if (is_null($extp_first)){
            $extp_first = cot_getextplugins('vuz.schedule.tags.first');
            $extp_main  = cot_getextplugins('vuz.schedule.tags.main');
        }

        /* === Hook === */
        foreach ($extp_first as $pl){
            include $pl;
        }
        /* ===== */

        if(empty($urlParams)) $urlParams = array();
        if(empty($urlParams['m'])) $urlParams['m'] = 'group';
        if(empty($urlParams['a'])) $urlParams['a'] = 'schedule';

        if ( ($item instanceof vuz_model_Schedule) && is_array($cacheArr[$item->id]) ) {
            $temp_array = $cacheArr[$item->id];
        }elseif (is_int($item) && is_array($cacheArr[$item])){
            $temp_array = $cacheArr[$item];
        }else{
            if (is_int($item) && $item > 0){
                $item = vuz_model_Schedule::getById($item);
            }
            /** @var vuz_model_Schedule $item  */
            if ($item){

                // Права
                // Задание может править автор или староста
                $scheduleAuth['isadmin'] = cot_auth('vuz', 'a', 'A');
                if($scheduleAuth['isadmin']){
                    $scheduleAuth['auth_write'] = true;

                }elseif(cot::$usr['id'] == $item->created_by){
                    $scheduleAuth['auth_write'] = true;

                }else{
                    $grpAuth['isLeader'] = $item->sgroup->isLeader(cot::$usr);
                    if($grpAuth['isLeader']) $taskAuth['auth_write'] = true;

                }

                if(empty($urlParams['gid']) && !empty($grpIds)) $urlParams['gid'] = $item->sgroup->sgrp_id;
                $urlParams['sid'] = $item->id;

                $itemUrl = cot_url('vuz', $urlParams);
                $itemEditUrl = '';
                if($scheduleAuth['auth_write']){
                    $editUrlParams = $urlParams;
                    $editUrlParams['a'] = 'editSchedule';
                    $itemEditUrl = cot_url('vuz', $editUrlParams);
                }

                $itemDelUrl = '';
                if($scheduleAuth['auth_write']){
                    $editUrlParams = $urlParams;
                    $editUrlParams['a'] = 'deleteSchedule';
                    $itemDelUrl  = cot_confirm_url(cot_url('vuz', $editUrlParams),  'vuz', 'shedule_deleteConfirm');
                }

                $text = cot_parse($item->text);
                $text_cut = cot_cut_more($text);
                if ($textlength > 0 && mb_strlen($text_cut) > $textlength){
                    $text_cut = cot_string_truncate($text_cut, $textlength);
                }
                $cutted = (mb_strlen($text) > mb_strlen($text_cut)) ? true : false;

                $date_format = 'datetime_medium';
                $date_format = 'date_fulltext';
                $beginStamp = strtotime($item->begin);
                $endStamp = !empty($item->end) ? strtotime($item->end) : 0;
                $temp_array = array(
                    'URL' => $itemUrl,
                    'EDIT_URL' => $itemEditUrl,
                    'DELETE_URL' => $itemDelUrl,
                    'ID' => (int)$item->id,
                    'TITLE' => htmlspecialchars($item->TITLE),
                    'DISTPLAY_TITLE' => htmlspecialchars($item->displayTitle),
                    'DESC' => htmlspecialchars($item->description),
                    'BEGIN' => cot_date($date_format, $beginStamp),
                    'BEGIN_RAW' => $beginStamp,
                    'END' => cot_date($endStamp, $beginStamp),
                    'END_RAW' => $endStamp,
                    'TEXT' => $item->text,
                    'TEXT_CUT' => $text_cut,
                    'TEXT_IS_CUT' => $cutted,

                    'CREATED' => $item->created,
                    'CREATE_DATE' => cot_date($date_format, strtotime($item->created)),
                    'CREATED_RAW' => strtotime($item->created),

                    'UPDATED' => $item->updated,
                    'UPDATE_DATE' => cot_date($date_format, strtotime($item->updated)),
                    'UPDATED_RAW' => strtotime($item->updated),
                );

                /* === Hook === */
                foreach ($extp_main as $pl)
                {
                    include $pl;
                }
                /* ===== */
                $cacheitem && $cacheArr[$item->id] = $temp_array;
            }else{

            }
        }

        $return_array = array();
        foreach ($temp_array as $key => $val){
            $return_array[$tagPrefix . $key] = $val;
        }

        return $return_array;
    }

}

vuz_model_Schedule::__init();

Здесь очень важным является метод fieldList(), возвращающий массив с описанием полей в таблице. Обратите внимание на то, что модель не проверяет физическое наличие полей в таблице БД, а наивно доверяет возвращаемому массиву.
Ключом массива является имя поля, а значением массив с описанием в формате ключ=>значение и может содержать следующие данные:

'name' - название поля
'primary' - может быть только у одного поля. Значение true указывает на то, что поле явлается первичным ключом таблицы.
'type' - тип поля. Это SQL тип или 'link', если это поле является связью с другой моделью.
'length' - необязательно. Длина значения, например для varchar
'nullable' - необязательно. 'nullable' => false указывает на то, что поле не может принимать пустое значение.
'default' - необязательно. Значение по умолчанию. При создании нового экземпляра модели поле будет проинициализировано этим значением. Однако при получении существующего объекта, поле будет проинициализировано данными из БД.
'description' - необязательно. Описание поля.
'safe' - необязательно. Если TRUE , то поле является «защищенным» при заполнении модели данными методом setData(), при попытке заполнения этого поля выбросит исключение, если пользователь не является администратором или действие просходит не в панели управления.

Обращаться к полям модели можно как к обычным свойствам объекта.

Например:

$sсhedule = vuz_model_Schedule::getById(15);   // Получить существующий объект
$endStamp = !empty($sсhedule->end) ? strtotime($sсhedule->end) : 0;

Связи между моделями

Модель может содержать связи с другими моделями. Поддерживаются связи один-ко-многим и многие-ко-многим. Например, наше расписание принадлежит конкретной группе ВУЗ'а реализованной моделью vuz_model_Group. Эта связь описывается так:

'sgroup' =>
    array(
        'name' => 'sgroup',
        'type' => 'link',
        'description' => 'Группа Вуза',
        'link' =>
            array(
                'model'    => 'vuz_model_Group',
                'relation' => Som::TO_ONE_NULL,
                'label' => 'title',
            ),
        ),

Здесь в массив с описанием доля добавляется элемент 'link', описывающий связь:

'model' - имя класса связываемой модели
'relation' - тип связи. Возможные значения (константы класса Som):
    - Som::TO_ONE - один ко многим
    - Som::TO_ONE_NULL - один ко многим, разрешено пустое значение
    - Som::TO_MANY - многие ко многим
    - Som::TO_MANY_NULL - многие ко многим, разрешено пустое значение
'label' - необязательно. Свойство связываемого класса которое можно использовать для автоматического вывода связанных объектов. Напрмер 'title'.
'localkey' - необязательно. Имя поля в данной модели (а точнее в таблице БД), где хранится id связанного объекта. Используется только для связей один-ко-многим т.к. для хранения связей многие-ко-многим необходима отдельная таблица в БД, которая при необходимости создается автоматически.
Если параметр localkey не указан, то будет использовано само поле в котором описана связь. В данном случае - sgroup. Обратите внимание, что поле должно существовать в таблице в БД.

При обращении к полю связанному с другой моделью получим ссылку на объект этой модели. Например:

$prod = Product::getById(2);
echo $prod->topic->name; // Выведет поле name экземпляра класса «ProductTopic» (для один-ко-многим)

или

$prod = Product::getById(2);
// Это сработает, если у нас для поля $topics объявлена связь многие-ко-многим
foreach ($prod->topics as $topic){
    // do something ...
    echo $topic->name;
}

Запрос к базе данных на получение связанного объекта происходит только по необходимости. Т.е. в момент обращения

Полю со связью один-ко-многим можно присвоить id связанного объекта или сам объект

Например:

$prod = Product::getById(5);
$topic = ProductTopic::getById(2);

$prod->topic = 2;      // Присвоили id
$prod->topic = $topic; // Присвоили экземпляр класса ProductTopic(). По сути эти действия идентичны.

Присваивать можно либо самому объявленному полю, либо полю из БД, указанному в localkey

Присвоить можно только экземпляр того класса, каким объявлена связь.

Присваивание значений полям со связями многие-ко-многим аналогично с той разницей, что помимо id или самого объекта допускается присваивание содержащего их массива.

Основные методы класса Som_Model_Abstract

static _init($db = 'db')

Статический конструктор. Должен вызываться при включении файла конкретного класса модели. Выполняет начальную инициализацию модели, заполняет свойства $_db и $_columns. Он принимает один единственный необязательный параметр $db - тип базы данных, по-умолчанию используется соединение с БД Cotonti.

__construct($data = null)

Конструктор экземпляра. Автоматически вызывается при создании экземпляра модели.

Может принимать в качестве параметра другой экземпляр той же модели или массив (ключ-значение). В этом случае поля объекта будут инициализированы соответствующими значениями.

protected function afterDelete()

Выполняется после удаления объекта. По умолчанию метод ничего не делает, но Вы можете переопределить его для выполнения неких действий, спецефичных для Вашей модели.

protected function afterInsert()

Выполняется после добавления нового объекта в БД. По умолчанию метод ничего не делает, но Вы можете переопределить его для выполнения неких действий, спецефичных для Вашей модели.

protected function afterSave()

Выполняется после сохранения объекта независимо от того, есть соотвествующая запись в БД или нет. По умолчанию метод ничего не делает, но Вы можете переопределить его для выполнения неких действий, спецефичных для Вашей модели.

protected function afterSetData($data)

Выполняется после заполнения модели данными методом setData(); По умолчанию метод ничего не делает, но Вы можете переопределить его для выполнения неких действий, спецефичных для Вашей модели.

protected function afterUpdate()

Выполняется после существующего объекта. По умолчанию метод ничего не делает, но Вы можете переопределить его для выполнения неких действий, спецефичных для Вашей модели.

protected function beforeDelete()

Выполняется перед удалением объекта. По умолчанию метод возвращает TRUE, но Вы можете переопределить его для выполнения неких действий, спецефичных для Вашей модели. Если метод вернет FALSE, удаление не произойдет и метод afterDelete() выполнен не будет.

protected function beforeInsert()

Выполняется перед сохранением нового объекта. По умолчанию метод возвращает TRUE, но Вы можете переопределить его для выполнения неких действий, спецефичных для Вашей модели. Если метод вернет FALSE, добавления объекта в БД не произойдет и метод afterInsert() выполнен не будет.

protected function beforeSave($data)

Выполняется перед сохранением объекта независимо от того, есть соотвествующая запись в БД или нет. По умолчанию метод возвращает TRUE, но Вы можете переопределить его для выполнения неких действий, спецефичных для Вашей модели. Если метод вернет FALSE, сохранение не произойдет и метод afterSave() выполнен не будет.

protected function beforeSetData($data)

Выполняется перед заполнением модели данными методом setData(); По умолчанию метод возвращает TRUE, но Вы можете переопределить его для выполнения неких действий, спецефичных для Вашей модели. Если метод вернет FALSE, заполнение данными не произойдет и метод afterSetData() выполнен не будет.

protected function beforeUpdate()

Выполняется перед сохранением существующего объекта. По умолчанию метод возвращает TRUE, но Вы можете переопределить его для выполнения неких действий, спецефичных для Вашей модели. Если метод вернет FALSE, сохранение объекта не произойдет и метод afterUpdate() выполнен не будет.

static count($conditions)

Возвращает количество элементов, соотвествующих условию, переданному в параметре $conditions

dec($pair = array(), $conditions = '')

Декремент. Уменьшает заданные поля на заданные значения. Запись в БД производится сразу при вызове метода.

delete()

Удалить данных объект из базы данных

protected static fetch($conditions = array(), $limit = 0, $offset = 0, $order = '')

Защищенный Метод. Он осуществляет выборку объектов из БД. Возвращает массив экземпляров класса, если объект существует или null если ничего не найдено. Публичные методы getById(), fetchOne() и find() являются по сути обертками для этого метода и делегируют запрос ему.

Хоть этот метод и нельзя вызвать извне, но его полезно переопределять для создания выборок, специфичных для конкретной модели. В этом случае методы getById(), fetchOne() и find() будут делегировать запрос переопределенному методу, даже если сами они и не переопределены.

static fetchOne($conditions, $order = null)

Получить объект по заданным условиям. Возвращает экземпляр класса, если объект существует или null в противном случае.

где:

$conditions - условия
$order - условие для сортировки - поле или поля чере запятую. В последнем случае для каждого поля можено указать порядок сортировки (ASC или DESC). Также может принимать массив условий, элементами которого являются массивы, ключи которых - поля, а значения - порядок сортировки.

Получаемый объект кешируется на время выполнения аналогично методу getById().

static find($conditions, $limit = 0, $offset = 0, $order = '')

Найти объекты по заданным условиям. Возвращает массив экземпляров класса, если объект существует или null если ничего не найдено.

где:

$conditions - условия
$limit - Количество выбираемых элементов
$offset - Смещение выборки от начально элемента
$order - условие для сортировки - поле или поля чере запятую. В последнем случае для каждого поля можено указать порядок сортировки (ASC или DESC). Также может принимать массив условий, элементами которого являются массивы, ключи которых - поля, а значения - порядок сортировки.

static getById($pk, $staticCache = true)

Получить объект по первичному ключу. Возвращает экземпляр класса, если объект существует или null в противном случае. Если параметр $staticCache - true, то результат работы кешируется на время жизни скрипта. Т.е. если для конкретной модели вызывать несколько раз этот метод с одним и тем же параметром, запрос к БД выполняется только один раз, потом возвращается ссылка на объект из кеша. При сохранении/удалении объекта кеш сбрасывается.

Кеширование нужно отключить, если используется несколько объектов с одним первичным ключом и разными наборами опций.

static getDbConfig()

Возвращает настройки БД для данного объекта в виде массива.

static fields()

Возвращает массив полей, описанных в модели, с типами данных и связей.

getId()

Возвращает значение первичного ключа объекта

getValidators($field = null)

Возвращает валидаторы для указанного поля объекта или все валидаторы объекта. Валидаторы используются для проверки данных объекта при его сохранении.

inc($pair = array(), $conditions = '')

Инкремент. Увеличивает заданные поля на заданные значения. Запись в БД производится сразу при вызове метода.

static primaryKey()

Возвращает название поля первичного ключа модели.

rawValue($column)

Возвращает значение поля $column «как есть». Никакие преобразования не производятся. Для связей "ко многим" связанные объекты из БД не выбираются, возвращается массив значений первичного ключа связанных объектов (массив их id)

save($data = null)

Сохранить текущий объект. качестве аргумента можно передать массив (ключ-значение). В этом случае перед сохранением поля объекта будут перезаписаны данными из массива.

setData($data, $safe=true)

Безопасное заполнение модели данными. Принимает следующие параметры:

$data - массив данных в формате имя_поля => значение. Например $_POST.
$safe - Если параметр установлен в TRUE и при этом действие происходит не в панели управления и пользователь не администратор ($usr['isadmin'] != TRUE), то при попытке передать в массиве $data имя_поля, которое в описании в моделе имеет элемент 'safe' => TRUE, будет выброшено исключение.

Данные при установке значений проходят проверку на соотвествие типам данных. Вам не нужно заботиться о рутинной проверке вводимых пользователями данных.

setValidator($field, $validators)

Устанавливает валидатор(ы) для заданного поля объекта

toArray()

Возвращает поля текущего объекта в виде массива.

static updateRows($data, $condition = '')

Обновить все записи в таблице, соотвествующие условию $condition.

Принимает следующие параметры:
$data - массив данных в формате имя_поля => значение.
$condition - Любое допустимое условие для выборки

validate($fields = null)

Проверяет модель на наличие ошибок. Если в качестве параметра передан массив, то проверяет только те поля, которые перечислены в массиве. Проверка осуществляется при помощи установленных для данного объекта валидаторов. Также поля проверяются на соответствие типу данных.

Этот метод полезно переопределять для создания проверок спецефичных для конкретной модели

Получение объектов

Получение объектов осуществляется описанными выше методами getById(), fetchOne() и find()

Условия для выборки

Условия для выборки передаются через параметр $conditions методов fetchOne() и find().

Рассмотрим синтаксис этого параметра:

Он может быть:

Cтрока, соотвествующая SQL - синтаксису WHERE

Например:

$productArr = Product::find('id > 2 AND id_rasdel = 2');

В этом случае синтаксис зависит от типа БД и применять его стоит только в крайнем случае, т.к. может ограничить переносимость скрипта между разными типами БД. К тому же это не безопасно. Тут надо проверять передаваемые условия, чтобы исключить возможность sql инъекций, экранировать строковые значения.

Массив

Элемент массива строка

1. строка соотвествует формату <колонка> <оператор (<, >, =, больше или равно, меньше или равно, не равно)> <значение>

Например:

$products = Product::find(array('id >= 2', 'id < 5'));

Строковые значения в этом случае экранируются автоматически.

Будьте внимательны! Выборка

$this->item = Unittest_Model_Item::find(array('uti_id=1 OR uti_id=3'));

будет интерпретирована как

SELECT `unittest_item`.* FROM `unittest_item` WHERE (uti_id = '1 OR uti_id=3')

а это, скорее всего, не то чего Вы ожидали. Для правильной работы подобных запросов используйте массив массивов в качестве параметра

2. Строка не соответствует указанному формату

Например:

$products = Product::find(array('id IN(1,2,5)'));

В этом случае условие принимается 'как есть' и добавляется к предложению WHERE, по аналогии с Cтрока, соотвествующая SQL - синтаксису WHERE Элементы массива добавляются к предложению WHERE с добавлением AND между ними.

Нарпимер:

$products = Product::find(array('id >= 2', 'id < 5'));

Соотвествует условию:

WHERE katalogshop_sale.id >= 2 AND katalogshop_sale.id < 5

Элемент массива - массив

Массив может состоять из 4-х элементов, из которых первые два являются обязательными.

Нарпимер:

$products = Product::find(array(
    array('id', '2'),
    array('id', '5', '<','OR')
));

Расмотрим элементы массива:

1-ый - поле в БД
2-ой - значение
3-ий - операнд (< > = больше или равно, меньше или равно, не равно и т.п.), если не указано, то принимается равным '='
4-ый - Условие объединения (AND ИЛИ OR), если не указано, то принимается равным 'AND'

Так приведенный пример соотвествует условию:

WHERE katalogshop_sale.id = 2 OR katalogshop_sale.id < 5

Если перый элемент массива равен 'RAW' или 'SQL' то к предложению WHERE добавляется второй элемент (значение) «Как есть», по аналогии с Cтрока, соотвествующая SQL - синтаксису WHERE

Значение может быть массивом

Например:

$cats = array(1, 2, 4);
$prod = Product::find(array(
    array('id_rasdel', $cats)
));

Будет соответствовать:

WHERE katalogshop_sale.id_rasdel IN (1,2,4);

$cats = array(1, 2, 4);
$prod = Product::find(array(
    array('id_rasdel', $cats, '<>')
));

Будет соответствовать условию:

WHERE katalogshop_sale.id_rasdel NOT IN (1,2,4);

Строковые значения в переданном массиве экранируются.

Значение может быть NULL

Например:

$prod = Product::find(array(
    array('id_rasdel', null)
));

Будет соответствовать:

WHERE katalogshop_sale.id_rasdel IS NULL;

$prod = Product::find(array(
    array('id_rasdel', null, '<>')
));

Будет соответствовать условию:

WHERE katalogshop_sale.id_rasdel IS NOT NULL;

Построение LIKE условий

Если значение содержит '*', то в предложение WHERE будет добавлено LIKE

Например:

$prod = Product::find(array(
    array('name', '*водонагреватель*')
));

Будет соответствовать условию:

WHERE katalogshop_sale.name LIKE '%водонагреватель%';

Так, к примеру для MySql '*' заменяется на '%'

Строковые значения экранируются.

Валидаторы. Проверка объектов.

Как уже отмечалось ранее, при сохранении объекта, его данные проходят проверку на соответствие типу данных, указанному в описании поля.

Дополнительную проверку данных можно обеспечить при помощи валидаторов.

Поддерживается 2 типа валидаторов:

Строковые валидаторы

В качестве строки выступает название типа данных: int, integer, bool, boolean, double, float, isnull, notnull, empty, notempty. Последние 4 - не являются типами данных и осуществляют проверку на соотвествие значения 'NULL' и на пустое значение.

Callback функции

В качестве валидатора можно передать функцию. Она должна по результатом проверки возвращать 'true' или строку с описанием ошибки.

Передача имени функции

Пример:

function myFunction($value){
// some validation
return true;
}
$prod = Product::getById(2);
$prod->setValidator('description', 'myFunction');

Использование анонимных функций

Пример:

$prod->setValidator('description', function($value){
    if(mb_strlen($value) > 30)  return true;
    return "Описание слишком короткое";
});

Использование методов классов

Пример:

class MyClass{
    public static function test($value)    {
        // some validation
        return true;
    }
}
$prod->setValidator('description', array('MyClass', 'test'));

Для нестатичного метода класса определение валидатора схоже с примером выше, с той разницей, что перед установкой валидатора нужно создать экземпляр класса и потом уже создать массив:

class MyClass {
    public function myMethod($value){
        // some validation
        return true;
    }
}
$object = new MyClass;
$prod->setValidator('description', array($object, 'myMethod'));

И, наконец, Вы можете определить в своем классе магический метод _invoke(). В этом случае в качестве валидатора просто передайте экземпляр класса.

class MyClass{
    public function __invoke($value) {
        // some validation
        return true;
    }
}

$object = new MyClass();
$prod->setValidator('description', $object);

Установка валидаторов

Валидаторы можно установить на стадии проектирования модели или в период выполнения в контроллере.

Для установки валидатора в классе модели следует переопределить метод validators(). Например:

protected function validators() {
    return array(
        array('specialization,birthdate,city,category,staff,skills,education', 'required'),
        array('staff', function ($value) {
            // Сделать невозможным указание одновременно уровней в штатном расписании «Стажер» c любым другим уровнем
            if(!empty($value) && in_array(5, $value) && count($value) > 1) {
                return 'Нельзя указать «Стажер» одновременно с другими уровнями в штатном расписании';
            }
            $ret = (count($value) < 3) ? true : 'Можно использовать не более двух уровней в штатном расписании';

            return $ret;
        }),
    );
}

Во время выполнения установить валидатор для поля объекта можно методом setValidator($field, $validators) Он принимает в качестве параметров имя поля и валидатор любого из перечисленных типов.

Например:

$prod = Product::getById(2);
$prod->setValidator('description', 'notempty');
$prod->setValidator('description', function($value){
    if(mb_strlen($value) > 30)  return true;
    return "Описание слишком короткое";
});

Получение списка валидаторов

получить валидаторы можно методом getValidators($field = null) Он возвращает массив валидаторов, установленных для заданного поля или все валидаторы объекта, если параметр опущен.

Сеттеры и Геттеры

Как и указывалось выше, доступ к полям записи в БД, представленной объектом производится через его свойства. Однако Вы можете переопределить стандартное поведение для некоторых полей или даже добавить объекту новые свойства, не привязанные к полям в БД.

Делается это при помощи волшебных методов - сеттеров и геттеров.

Например вы в классе модели можете добавить новое динамическое поле:

setMyField($val){
    $this->_myField = $val;
}

getMyField(){
    return $val;
}

Как видим формат имени метода: set<имя_поля_с_большой_буквы>. Префикс «set» используется для сеттера, а «get» - для геттера.

После этого мы можем обращаться к этим полям:

$object = module_model_Object::getById(2);

$object->myField = 15;
echo $object->myField;

Данный пример очень простой. Вы можете создать более сложную логику для своих сеттеров и геттеров. Переопределение сеттеров и геттеров для существующих полей происходит аналогично. Просто создайте метод с названием set<имя_существующего_поля_с_большой_буквы>.

Обратите внимание на то, что сеттер должен принимать значение.

Loader. Загрузчик

Tue, 06 May 2014 22:11:00 +0300

Этот компонент устарел и используется только для обратной совместимости. Используйте вместо него встроенный в Cotonti автозагрузчик Composer'a.

Класс «Loader», объявленный в файле «Loader.php» предназначен для автоматической загрузки описаний классов и интерфейсов. Автозагрузка происходит в момент первого обращения к классу и Вам не нужно беспокоиться о том, подключили Вы php-файл, содержащий описание класса или нет.

Для регистрации автозагрузчика в стэке __autoload служит статический метод register(). Вызывается так:

// Автозагрузка
require_once './lib/Loader.php';
Loader::register();

Регистрация автозагрузчика происходит в плагине cotonti-lib, так что Вам не нужно заботиться о подключении автозагрузчика в своих расширениях.

Метод регистрирует автозагрузчик только один раз. По этому даже если Вы его подключаете явно, ничего плохого не случится.

Как происходит автозагрузка:

Строка, задающая класс, согласно стандарта кодирования psr-0 (https://gist.github.com/Thinkscape/1234504), преобразуется в относительный путь посредством замены знаков подчеркивания разделителями директорий, используемыми в вашей ОС, и добавления расширения «.php». Например, для класса «files_model_File» на Windows будет использоваться путь «files\model\File.php».

Затем полученный файл ищется в папках «modules», «plugins», «lib» и папках заданных в настройке конфигурации include_path. Будет загружен первый встретившийся файл.

Так, если у Вас установлен модуль Файлов - «Files», то при первом обращении к упомянотому выше классу «files_model_File» будет загружен файл «modules/files/model/File.php»

Cotonti. Alpha Filters

Thu, 13 Feb 2014 12:17:00 +0300

тип: плагин
Версия плагина: 5.0
Совместимость: Siena

Авторы: esclkm, Kalnov Alexey, Cotonti Team

Github: https://github.com/Alex300/cotonti-alphafilters

Описание:

Плагин «Alpha Filters» предоставляет гибкие возможности по фильтрации списков страниц и пользователей по буквам, цифрам или комбинациям символов. Вы можете назначить свои стили элементам фильтра (тег: «span»).

Установка

Распаковать плагин в папку plugins
Установить плагин в панели администратора
Add tags to page.list.tpl and/or users.tpl
При необходимости можно установить свои настройки

Пример для шаблона users.tpl:



     {PHP.L.alphafilters_byFirstLetter}:
     {ALPHAFILTER_1} {ALPHAFILTER_2}
     
{ALPHAFILTER_3}
     {ALPHAFILTER_RESET}

Пример плагина:

7. Экстраполя

Wed, 14 Aug 2013 17:35:00 +0300

Модуль интернет магазина для Cotonti позволяет добавлять и использовать дополнительные экстраполя товаров, информации о пользователе и заказов.

На странице настроек магазина ( <ваш домен>/admin/config?n=edit&o=module&p=shop ) Вы видите какие поля создаются для работы модуля.

Экстраполя товаров:

При сохранении заказа вместе с заказом сохраняются поля "Артикул" и "Не применять скидку по купону". Но вы можете добавить свои поля к товару ( cot_pages - Модуль Pages ). Чтобы они сохранялись вместе с заказом, необходимо добавить поля с такими же названиями в cot_shop_order_items - Модуль «Shop».

Если имена экстраполей для таблиц cot_pages и cot_shop_order_items совпадают, то их значения сохраняются при формировании заказа автоматически.

Экстраполя пользователя:

Модуль использует данные профиля пользователя (экстраполя добавляются cot_users - Модуль Users) и адреса доставки пользователя (cot_shop_userinfo - Модуль «Shop»).

По аналогии с товарами для сохранения дополнительных данных с заказом, нужно добавить экстраполя в cot_shop_order_userinfo - Модуль «Shop»

При совпадении названий полей они будут сохранены с заказом ("Информация о покупателе" или "Адрес доставки" соотвественно).

Экстраполя заказа:

Добавляются в cot_shop_orders - Модуль «Shop». Позволяют пользователю или администратору магазина сохранять с заказом дополнительную информацию.

Для добавления этих полей на страницу корзины, их следует добавить в шаблон shop.cart.tpl в форму оформления заказа. Она в этом файле помечена соотвествующим комментарием.

Теги для вставки полей в эту форму имеют формат: {ORDER_FORM_XXXXX} и {ORDER_FORM_XXXXX_TITLE}

Значения этих полей можно вывести в списке заказов, при просмотре заказа, или в письме уведомлении о заказе. Для этого нужно их теги добавить в соотвествующий шаблон. Названия тегов можно получить на странице редактирования экстраполя из всплывающей подсказки к названию поля.

Администратор в панели управления при просмотре/редактировании заказа может изменять значения этих экстраполей. Это может быть полезно, если, например, администратору нужно вести какие-то заметки к заказу.

Теги для вставки редактируемых экстраполей в шаблоне shop.admin.order.tpl аналогичны тегам для шаблона shop.cart.tpl.

6. Производители

Sun, 21 Jul 2013 11:52:00 +0300

Для добавления производителей в панели управления сайтом в разделе: "Управление сайтом / Расширения / Pages / Структура" создайте категорию для производителей. Она не должна быть вложенной в магазин. Создайте ее отдельно. Укажите ее код в настройках модуля "Магазин".

Созданные в ней страницы и будут страницами производителей.

Страницы производителей могут содержать краткую или подробную информацию об изготовителе товаров, его контактную информацию, информацию о гарантиях, предоставляемых производителем и т.д.

Страницы производителей привязываются к товарам, что избавляет Вас от ввода однотипных данных при каждом добавлении товара. Кроме того, заполненное поле "Производитель" у товара позволяет организовать фильтр по этому полю и поиск всех товаров заданного производителя.

Замечение: поиск и фильтр реализуются отдельными плагинами, такими как "List Filter"

В шаблон страницы page.shop.tpl вывести производителя можно напрмер так:




    {PHP.L.shop.manufacturer}:
    {PAGE_PROD_MANUFACTURER_NAME}

Если для Вашего интернет магазина страницы роизводителей не нужны - то не создавайте их. Их наличие не обязательно для сработы модуля.

4. Валюта

Mon, 15 Jul 2013 15:34:00 +0300

Модуль "Магазин" является мультивалютным. Вы можете устанавливать цены на товары в разных валютах. Покупатели могут просматривать цены тоже в разных валютах. Цена сначала конвертируется в алюту продавца, а затем уже в валюту, выбранную пользователем.

Автоматический курс валют

Модуль автоматически конвертирует валюты. По умолчанию используется курс по Европейскому Центробанку. Возможно установить свой конвертер. Модуль может сконвертировать валюту, только если такая возможность есть у конвертера.

Создание и редактирование валют

Для редактирования валют пройдите в панели администратора: "Управление сайтом / Расширения / Shop / Администрирование / Валюта".

Если вы хотите установить свой обменный курс для валюты установите в поле "Обменный курс" значение, отличное от нуля. В этом случае при преобразовании валюты будет учитываться именно это значение. Значение следует устанавливать относительно основной валюты.

Вы можете установить формат отображения для выбранной валюты и ее символ.

Также Вы можете создавать свои собственные валюты, например "Бонус за репутацию", "Клики", "Золото" и т.п.
Вы даже можете установить свою валюту как "Основную" для магазина и назначить для других других валют курс относительно ее.

5. Налогоги и правила расчета цен

Mon, 15 Jul 2013 15:14:00 +0300

Вы можете создавать свои правила расчета, которые будут учитываться при формировании окончательной цены на товар и стоимости заказа. Это могут быть налоги, наценки и скидки, которые можно назначать разным группам покупателей, например оптовикам, своим сотрудникам и т.п. Они могут применяться для всех товаров или для отдельных категорий, быть постоянными или временными.

Для добавления нового правила, в панели администратора "Управление сайтом / Расширения / Shop / Администрирование / Налоги и правила расчета" нажмите "Добавить".

Заполните необходимые поля и сохраните.

Рассмотрим некотрые поля подробнее:

Вид расчета

Указывается тип расчета.
Возможные варианты:
- Постоянная наценка/скидка (размер прибыли)
- Налог на товар
- Изменение цены до или после удержания налога
- Налог на стоимость заказа
- Изменение цены до или после удержания налога на стоимость заказа

'Постоянная наценка/скидка (размер прибыли)' применяется к цене (себестоимости) при расчете основной цены товара. Остальные правила применяются к основной цене.

При установке налога, посоветуйтесь с бухгалтером, если Вы сомневаетесь в правильности выбора. Как правило используется налог на товар.

"Арифметическое действие" и "Значение" устанавливают величину, на которую изменяется цена. Например
Арифметическое действие: "+%"
Значение: "20"
Означают, что цену нужно увеличить на 20 процентов.

Поля "Категории", "Группы" и "Страны" позволяют установить данное правило для соотвествующей категории товаров, группы покупателей (пользователей) и стран.

"Опубликовано с" и "Опубликовано по" ограничивают действие правила во времени.

Если какое-то из полей "Категории", "Группы", "Страны", "Опубликовано с" или "Опубликовано по" не заполнено, то соотвествующее ограничение не накладывается.

"Опубликовано". Если стоит "нет", то данное правило системой не применяется

Cotonti. Region-City ajax selector

Sun, 14 Jul 2013 23:11:00 +0300

Плагин для Выбора страны, региона и города.

тип: плагин
Версия плагина: 1.0.7
Совместимость: Siena

GitHub: https://github.com/Alex300/RegionCity/

Плагин позволяет добавить на Ваш сайт на Cotonti возможность выбора страны, региона и города из выпадающих списков при помощи Ajax.

Это может быть полезным для доски объявлений или интернет магазинов т.к. пользователь не вводит название города самостоятельно, а выбирает из предложенного плагином списка, что исключает неправильный ввод.

Системные требования и ограничения:

Наличие на Вашем сайте установленной библиотеки Cotonti Lib версии 2.0.x

Плагин выводит теги для выбора страны, региона и города в соотвествии со своими настройками на странице регистрации нового пользователя, в профиле и странице редактирования пользователя. А также выводит теги для фильтров на странице списка пользователей.

Вы можете использовать этот плагин из своих модулей и плагинов. Для этого используется функция генерерующая теги выбора страны, региона и города:

function rec_select_location($counName = 'country', $regName = 'region', $cityName = 'city', $country = '', $region = 0, $city = 0);

В качестве первых трех параметров принимаются названия полей для страны, региона и города соотвественно. Или массивы, первым элементом которого является имя элемента формы, а вторым имя тега, который его выводит.

Четвертый, пятый и шестой параметры - это код страны и id региона и города.

Пример использования:

$t->assign(rec_select_location(
    array('recf_country', 'USERS_TOP_FILTERS_COUNTRY'),
    array('recf_region',  'USERS_TOP_FILTERS_REGION'),
    array('recf_city',    'USERS_TOP_FILTERS_CITY'),
    'ru',  4052, 4079)
);

Сгенерированные этой функции элементы передадут не только ID города и региона, но и их названия. Названия передаются в полях "<имя_поля>_name". Например, форма из примера выше передаст id региона в поле "recf_region" а его название в поле "recf_region_name". Id и название города будут переданы соотвественно в полях: "recf_city" и "recf_city_name"

Также, если на Вашем сайте установлена библиотека Select2, Вы можете выводить выбор города одним выпадающим списком с поиском по названию. Для этого используется функция

/**
 * Renders a Select2 city dropdown
 *
 * Select2 must be installed on your site
 * @see http://ivaynberg.github.io/select2/
 *
 * @param string $name Dropdown name
 * @param int array|int $chosen Seleced value (or values array for mutli-select)
 * @param bool $add_empty Allow empty choice
 * @param mixed $attrs Additional attributes as an associative array or a string
 * @param string $custom_rc Custom resource string name
 * @return string
 */
function rec_select2_city($name, $chosen = 0, $add_empty = true, $attrs = array(), $custom_rc = '' )

Например:

$t->assign(array(
    //...
    'FORM_CITY' => rec_select2_city('city', $vacancy->city),
));

выводить отдельно выбор страны и региона в этом случае не нужно.

История изменений:

Версия v.1.0.7

Совместимость с Cotonti 0.9.25

Версия v.1.0.5

Совместимость с Cotonti Lib v.2.0.

Версия v.1.0.4

Профили пользователя могут иметь несколько групп полей («Страна», «Регион», «Город»). Например домашний и рабочий адреса.

Версия v.1.0.3

Городам добавлено поле 'sort' для сортировки. Сортировка осуществляется по-убыванию. Города с одинаковым значением этого поля сортируются по алфавиту
Изменены поля таблиц в БД и моделях на более читабельные. (обратите внимание на этот момент при обновлении)

Версия v.1.0.2

Виджет rec_select2_city() теперь использует Select2 v.4

Версия v.1.0.1

Использование моделей из библиотеки Cotonti Lib вместо собственных. Это сделано в целях унификации API и оптимизации потребления системных рессурсов
Выпадающий список на основе Select2 для выбора города с поиском по введенным буквам

GitHub: https://github.com/Alex300/RegionCity/

3. Редактирование товара

Sun, 14 Jul 2013 17:13:00 +0300

Для облегчения работы по созданию шаблонов добавления / редактирования страниц-товаров в модуль "Магазин" для Cotonti включены образцы https://github.com/Alex300/cotonti-shop/tree/master/themes/your-theme/modules

page.add.shop.tpl и page.edit.shop.tpl

в которых форма редактирования товара разбита на вкладки при помощи Twitter bootstrap.

Рассмотрим эти вкладки подробнее:

Информация / описание.

Эта вкладка содержит стандартные поля редактирования страниц Cotonti.

Стоимость.

На этой вкладке задается цена товара.

"Цена (себестоимость)" позволяет ввести цену на товар и валюту, в которой указана цена.

"Основная цена" и "Окончательная цена" будут расчитаны системой автоматически.

"Основная цена" - это "Цена (себестоимость)" преобразованная в валюту продавца и расчитанная с учетом наценки, если она применяется к данному товару.

Наценки и другие правила расчета цены можно увидеть в панели администратора "Управление сайтом / Расширения / Shop / Администрирование / Налоги и правила расчета". Подробнее о них читайте в соответствующем разделе руководства.

"Окончательная цена" - это "Основная цена" расчитанная со всеми правилами, применимыми к данному товару. Это та цена, которую необходимо оплатить покупателю при заказе данного товара.

Расчет поля "Цена (себестоимость)" на основе окончательной цены.

Вы можете устанавливать окончательную цену на товар (вместо себестоимости). При этом поля "Цена (себестоимость)" и "Основная цена" будут расчитаны системой автоматически с учетом всех правил расчета.

Для этого нужно заполнить поле "Окончательная цена" и отметить "Расчет себестоимости".

Переопределение цены

Позволяет назначить временную скидку или наценку на конкретный товар. Вы можете переопределить основную или окончательныу цену выбрав "Переопределение до удержания налога" или "Переопределение окончательной цены" соотвечтвенно.

Если выбрано "Не применять скидку по купону" то при расчете стоимости заказа на данный товар не будет распространяться скидка по купону. Имеет смысл использовать, если цена на товар и так уже указана со скидкой (нарпимер товар участвует в акции), либо если на данный товар скидок нет.

Дополнительные цены

Позволяют задать стоимоть товара с учетом группу покупателя, а также в зависимости от количества приобретаемого товара. Например для группы пользователей "Оптовик", цена возможно будет ниже, чем для Members.

Обратите внимание, что скидки, которые зависят от группы пользователя Вы можете назначать для всех товаров или для отдельных катерий на странице "Управление сайтом / Расширения / Shop / Администрирование / Налоги и правила расчета"

Правила расчета цены

Отображают текущие правила (налоги и скидки), применяемые к расчету цены на товар.
Вы можете отключить правила для данного товара, выбрать какое-то одно правило или оставить по-умолчанию

Статус / покупатели

На этой вкладке можно установить или увидеть сколько данного товара имеется в наличии, сколько зарезервированно заказами.
Когда товар на складе заканчивается, то в зависимости от настроек магазина, покупателю может быть отказано в покупке данного товара.

Минимальное и максимальное количество для заказа - накладывают ограничения на возможное количество приобретаемого товара.

Шаг (по умолчанию 1) позволяет ограничить количество приобретаемого товара только значениями крантыми данному.

"Разрешить заказывать дробное кол-во" позволяет заказывать дробное количество товара (Например: 5,5 кг картофеля или 30,6 м2 ламината)

Список покупателей, которые приобрели

Появится в следующих версиях. Список покупателей, заказавших этот товар.

Список ожидающих покупателей

Список покупетелей, подписавшихся на уведомление о поступлении товара на склад.
Работает, если в настройках магазина указано если товара нет на складе - "Показывать 'Уведомить меня' вместо кнопки 'Добавить в корзину'"

Габариты / вес

На этой вкладке настраиваются габариты, товара, его вес, количество в упаковке и т.п.

Изображения / файла

Тут рекомендуется использовать плагин Attachments 2 для добавления изображений товара.

2. Способы оплаты и доставки

Fri, 12 Jul 2013 16:36:00 +0300

В модуль магазина "Shop" уже включает в себя по одному стандартному плагину оплаты и доставки. Это "Shop - Payment plugin Standard", "Shop - Shipment, By weight, ZIP and countries"

Также возможна установка дополнительных плагинов.

Работа со способами оплаты и доставки схожа.

Рассмотрим добавление способа оплаты более подробно.

Перейдем в панель управления: Управление сайтом / Расширения / Shop / Администрирование
Выберем "Способы оплаты". "Добавить"

Заполняем поля. Выбираем нужный плагин из списка. Выберем "Shop - Payment plugin Standard".
Если выбрать группы пользователей, то он будет доступен только для этих групп.

Нажмем "Отправить" для сохранения.

После сохранения система автоматически перейдет к редактированию вновь созданного способа.
И под формой, которую мы только что заполнили появится форма конфигурации с настройками, спецефичными уже для выбранного плагина.

Плагин "Shop - Payment plugin Standard" в числе прочих содержит настройки: "Страны", "Минимальная сумма заказа", "Максимальная сумма заказа", которые могут ограничить применение данного способа.

Например, если добавить страну "Россия", то этот способ оплаты можно будет использовать только, если в адресе доставки покупателя при оформлении заказа указана "россия".

Если "Минимальная сумма заказа" установлено в 1000, то данных способ оплаты нельзя будет выбрать при сумме заказа ниже 1000 рублей.

Если эти поля не настроены, то никаких ограничений не накладывается.

Также этот плагин позволяет назначить сумму, которая будет прибавляться к стоимости заказа за использование данного метода. Сумму можно указать как абсолютную, так и в процентах от стоимости заказа.

Заполняем необходимые поля. Сохраняем.

Работа с плагинм доставки "Shop - Shipment, By weight, ZIP and countries" происходит аналогично. Вы лекго можете добавить способ доставки, скажем "Курьером" стоимостью 300 рублей.

1. Установка

Fri, 12 Jul 2013 12:44:00 +0300

Скачайте последнюю версию с GitHub: https://github.com/Alex300/cotonti-shop

Содержимое папок «modules» и «plugins» скопируйте в соотвествующие папки на Вашем сайте.

На файл «modules/shop/cache/convertECB_daily.xml» установите права на запись.

Установите модуль «Shop» и плагины «Shop - Payment plugin Standard», «Shop - Shipment, By weight, ZIP and countries» из панели администратора.

Плагины «Shop - Payment plugin Standard» и «Shop - Shipment, By weight, ZIP and countries» это стандартные плагины оплаты и доставки.

В файл «admin.users.add.tags» в формы добавления и редактирования группы пользователей добавте теги {ADMIN_USERS_NGRP_MIN_PURCHASE} и {ADMIN_USERS_NGRP_VENDOR_CURRENCY}, соответсвенно. Это добавит возможность устанавливать минимальную сумму заказа для группы пользователей.

Например для формы редактирования:


    {PHP.L.shop.order_min_total}:
    {ADMIN_USERS_EDITFORM_GRP_MIN_PURCHASE} {ADMIN_USERS_EDITFORM_GRP_VENDOR_CURRENCY}

Чтобы при обновлении Cotonti эти изменения не потерялись, можно этот файл скопировать в папку: themes/<ваша_тема>/admin

Настройте магазин нажав кнопку "Конфигурация" на странице модуля в панели администратора.

Автоматическое создание экстраполей страниц и пользователя.

Для работы модуля необходимо создать некоторые экстраполя для страниц и пользователей. Сделать это можно на странице настройки самого модуля в разделах "Экстраполя страниц" и "Экстраполя пользователей (Реквизиты)". Тут можно указать свои экстраполя или оставить те, что предлагаются по-умолчанию. Когда все поля указаны, после нажатие кнопки "Создать все экстраполя" они будут созданы автоматически. Данная процедура только создает новые поля. Существующие не затрагиваются.

Настройки магазина

Когда настройки модуля магазина закончены и сохранены, перейтиде в раздел Администрирования модуля. Там перейдите в раздел "Магазин", кликнув по соотвествующей кнопке. Заполните название и выберите валюту магазина, а также валюты, которые будут доступны пользователю при просмотре магазина.

Способы оплаты и доставки

В разделе Администрирования модуля перейдите на страницу "Способы оплаты". Добавте и сохраните способ оплаты. После сохранения можно настроить дополнительные параметры. Подробнее читайте в соотвествующем разделе документации.

Тоже самое сделайте для способа доставки.

Шаблоны

Для облегчения настройки шаблонов отображения и редактирования товаров в репизитории на GitHub: https://github.com/Alex300/cotonti-shop/tree/master/themes/your-theme есть образцы шаблонов для списка страниц, самой страницы товара и страниц добавления / редактирования товара. Обратие внимание: магазин для хранения товаров использует модуль страниц.

Добавление в шаблоны вывода корзины и выбора валюты

Корзину и выбор валюты можно вывести в любой шаблон. В зависимости от настроек магазина корзина будет отображаться только в магазине или на всем сайте.

Корзина выводится тегом: {PHP|minicart}

Например:

{PHP|minicart}

Выбор валюты выводится тегом: {PHP.currencySelect}

Например:



 {PHP.L.shop.currency_select}:

{PHP.currencySelect}

Добавление разделов и товаров.

В панели управления сайтом в разделе: Управление сайтом / Расширения / Pages / Структура создайте категорию магазина и при необходимости подкатегории. Код корневой категории следует указать в настройках модуля магазина.

Можно добавлять товары.

Производители

Для товаров можно создать страницы производителей. Для этого в панели управления сайтом в разделе: Управление сайтом / Расширения / Pages / Структура создайте категорию для производителей. Она не должна быть вложенной в магазин. Создайте ее отдельно. Укажите ее код в настройках модуля. Созданные в ней страницы и будут страницами производителей.

При редактировании товара можно выбирать произволителя из этой категории.

Cotonti. Онлайн-консультант.

Wed, 22 May 2013 13:00:00 +0300

Модуль «Онлайн-консультант». Позволяет организовать на Вашем сайте на Cotonti онлайн-консультирование, поддержку пользователей, техническую поддержку и т.д. Вы и Ваши сотрудники могут общаться в one-to-one чате с посетителями Вашего сайта, оказывая им оперативную поддержку и увеличивая объем продаж. Общение происходит прямо в браузере.

Тип: модуль
Версия: 1.2.1
Совместимость: Siena

Модуль будет полезен для сайтов, в работе которых важна обратная связь с клиентами, например для интернет магазинов. Вы сможете общаться с вашими посетителями в реальном времени и предложить им именно то, что им нужно.

В отличие от многих подобных продкутов не требует для работы каких-нибудь дополнительных сервисов.

После установки модуля добавте тег {PHP.oC_button} в нужное место в шаблоне для вывода кнопки начала диалога.

На файл /modules/oconsultant/inc/procesed.txt поставте права на запись.

Операторами являются пользователи имеющие права на запись на этот модуль и (опционально) администраторы.

Возможности:

Основные возможности
   - Чат в реальном времени (без перезагрузки страниц)
   - Неограниченное количество операторов, чатов и пользователей
   - Выполняется на вашем сервере и домене с сайтом на Cotonti
   - Шаблоны и файлы рессурсов позволяют легко адаптировать дизайн

Открытие диалога
    - Отображение кнопки в зависимости от присутствия операторов
    - Возможность оставить офф-лайн сообщение при отсутствии операторов в онлайне
    - Капча для защиты от спама

Окно диалога
   - Возможность запросить дополнительную информацию перед началом чата
   - Уведомление о наборе текста собеседником
   - Аватар оператора и пользователя в окне диалога
   - Возможность отправки истории диалога себе на email
   - Звуковые и визуальные оповещения о новогых сообщениях
   - Отключение звукового оповещения в чате
   - Активные ссылки в окне чата
   - Автоматическое восстановление соединения с сервером

Возможности операторов
    - Веб-интерфейс для обслуживания посетителей
    - Режим "Отошел от компьютера" для оператора
    - Шаблоны сообщений для быстрого ответа
    - Отображение с какой страницы пришел посетитель
    - История сообщений с поиском
    - История диалогов
    - Информация о пользователях в очереди: первое сообщение, IP, браузер
    - Информация обо всех пользователях он-лайн
    - Возможность самому начать диалог с любым пользователем
    - Перенаправление во время чата посетителя на любую страницу Вашего сайта
    - Просмотр текущих диалогов администратором сайта
    - Перехват диалогов администратором сайта
    - Статистика

Что в планах:

- деление операторов по группам (например по отделам в организации)
- просмотр пользователем полной истории диалога

Условия использоания:

В диалоговых окнах модуля обязательно указание автора в виде прямой, незакрытой от индексации поисковыми системами ссылки на эту страницу ( http://portal30.ru/sozdanie-internet-sajtov/free-scripts/cotonti-onlajn-konsultant ) с текстом «powered by portal30». Либо Вы можете внести свой вклад в развитие проекта. Не обязательно деньгами. Можно, например переводом модуля на английский язык и составлением английского описания, улучшением функционала ))

GitHub: https://github.com/Alex300/Online-Consultant

Вопросы пожалуйста задавайте на форуме.

Cotonti - SecurImage CAPTCHA (Каптча)

Thu, 02 May 2013 15:04:00 +0300

Тип: плагин
Версия плагина: 2.03
Версия Securimage: 4.0.2
Совместимость: Siena

Использует класс Securimage (от Drew Phillips)
Для изменения настроек изображения отредактируйте файл /inc/imageshow.php (шрифт, кегль, фоновое изображение, шумы и т. д.)

Возможности:
- Вы можете использовать данную капчу везде, где она применяется на Вашем сайте: в форме регистрации, комментариях, обратной связи и т.п.
- Изображение можно обновить не перезагружая страницу
- Те, кто не может прочитать код, могут прослушать голосовой код

Образец работы каптчи можно посмотреть например в форме регистрации данного сайта.

Установка:
- скопировать папку captcha из архива в папку plugins на Вашем хостинге
- установить плагин в панели управления
- в настройках сайта в разделе Конфигурация -> Безопасность -> Captcha по умолчанию выбрать «Captcha»

Использования каптчи в своих плагинах:
Аналогично использованию любой другой капчи.

GitHub: https://github.com/Alex300/SecurImageCaptcha-for-Cotonti

Версия 1.0 для Cotonti Genoa

Joomla module. AN Carousel.

Thu, 18 Nov 2010 20:39:00 +0300

Этот модуль позволяет прокручивать графическую и текстовую информацию на Joomla! сайте. Прокручиваемыми элементами могут быть небольшие части материалов из указанной категории, к примеру краткие новости или категории товаров интернет магазина Virtuemat. В последнем случае, чтобы попасть в "прокрутку" категория должна иметь изображение и/или описание. При клике на прокручиваемом элементе пользователь перейдет на соответствующую страницу сайта. Прокрутка может быть как горизонтальной, так и вертикальной.

Версия модуля: 1.0.0 от 18.11.2010

Язык: русский, english

Примеры работы:

Астторгтех .

Скриншуты:

Что такое VirtueMart?:

Cкрипт интернет-магазина VirtueMart - одно из самых популярных в мире решений в области электронной коммерции. VirtueMart – это полностью готовое приложение для профессиональных компаний, при этом оно может быть адаптировано именно под ваши нужды на 100%.

VirtueMart является компонентом системы управления контентом Joomla! (Mambo) и не может использоваться без нее. Каждый, кто использует этот компонент, может продавать свой товар покупателям, не вникая в технические подробности интернет-торговли!

Что такое Joomla! ?:

Joomla! — (читается "Джумла") система управления содержанием (CMS), написанная на языках PHP и JavaScript, использующая в качестве хранилища содержания базу данных MySQL. Joomla! является свободным программным обеспечением, защищённым лицензией GPL. Одной из главных особенностей Joomla! является относительная простота управления при практически безграничных возможностях и гибкости при изготовлении сайтов.
CMS Joomla! включает в себя различные инструменты для изготовления веб-сайта. Важной особенностью системы является минимальный набор инструментов при начальной установке, который обогащается по мере необходимости. Это снижает загромождение административной панели ненужными элементами, а также снижает нагрузку на сервер и экономит место на хостинге.

Joomla module. VirtueMart. AN VM Accordion

Tue, 16 Nov 2010 21:51:00 +0300

Этот модуль выводит все категории компонента интернет магазина Viruemart Mart в виде раскрывающегося списка (Аккордиона).

Версия модуля: 1.0.1 от 16.11.2010

Язык: русский.

Примеры работы:

Торговый дом портал, Астторгтех .

Скриншуты:

Что такое VirtueMart?:

Что такое Joomla! ?:

Cotonti. Blogger.

Wed, 27 Oct 2010 21:49:00 +0300

Плагин пользовательских блогов для CMF Cotonti.

Тип: плагин
Версия плагина: 1.5.0
Совместимость: Siena

Описание:

Плагин расширяет функционал модуля страниц и позволяет пользователям, которым разрешено ведение блога (у этой группы есть право на запись W на данный плагин) создать свой блог – категория вложенная в корневую категорию блога. У них автоматически создается право на создание страниц в этой категории, а также (опционально), создание вложенных категорий. Автор блога может выбрать оформление для своего блога. Он имееет возможность получать уведомления о комментариях своих страниц на свой e-email.

Основные возможности:
- Темы оформления для каждого блога
- Категории внутри блогов
- Возможность премодерации публикаций
- Комментарии
- RSS лента
- Уведомления пользователя о новых комментариях.

Если на сайте включено автоутверждение страниц и пользователь имеет права '2' на этот плагин, то добавляемые им записи (страницы) утверждаются автоматически.

Поскольку плагин работает на стандартных категориях и страницах движка, то никаких дополнений для карты сайта и ЧПУ. Также он легко подхватится поиском, RSS и другими модулями / плагинами.

образец работы можно посмотреть тут: Ваши свадебные сайты.

Установка: стандартна.
- распаковать архив
- папку blogger скопировать на сервер в папку "plugins"
- установить и настроить в панеле управления.
- в файл скина page.list.tpl или users.details.tpl добавить необходимые теги.

Также прилагается образец файла файла page.list.tpl с тегами, специфичными для данного плагина

Старая версия плагина 1.0.0 для Cotonti Genoa.0.6.x (от 14.01.2011): Скачать

GitHub: https://github.com/Alex300/Blogger

Cotonti. Print, PDF Version, E-mail to friend

Sun, 18 Jul 2010 19:35:00 +0300

Плагин для Cotonti, позволяющий для страниц, категорий (списков) и форумов вывести в новом окне версию для печати (содержимое страницы без оформления), PDF версию, и форму для отправки ссылки на текущую страницу по e-mail (отправить другу). Опционально для форму отправки по e-mail можно использовать капчу. Для использования этой возможности должен быть установлен плагин CAPTCHA Manager и одна из капчей.

Версия плагина: 1.0.0

Язык: русский, english

Требования:
- jQuery

Установка:
- распаковать архив
- папку «an_ppve» скопировать на сервер в папку «plugins»
- установить и настроить в панеле администратора.
- в файлы скина «page.tpl», «list.tpl» и «forums.posts.tpl» добавить теги {PPVE_PRINT_VERSION},{PPVE_PDF_VERSION},{PPVE_EMAIL_TO_FRIEND}

Плагин тестировался с Cotonti Genoa 0.6.9

Образец работы Вы можете видеть на этом сайте.

Обсудить на форуме.

Cotonti. Плагин прогноза погоды.

Fri, 02 Apr 2010 22:14:00 +0300

Плагин прогноза погоды для CMF Cotonti. Он использует Google Weather API. Позволяет выводить текущую погоду и прогноз на 4 дня для выбранного города. Пользователь может выбрать любой город. Допускается ввод данных как на русском, так и на английском языке. Возможно отображение температуры воздуха как в градусах по Цельсию ( °С ), так и по Фаренгейту ( °F ). Выбранный пользователем город запоминается, и при следующем посещении пользователем сайта, ему отобразится прогноз для этого города.

Основные функции плагина:
- Вывод текущей погоды для указанного города
- Погодный информер на сайте
- Прогноз на 4 дня на отдельной странице.
- Город по-умолчанию указывается в настройках плагина в панели управления.
- В настройках плагина указывается отображать ли влажность, скорость ветра
- Кеширование данных
- Обновление данных в информере через Ajax

Версия плагина: 1.0.2 от 3 августа 2010 г.

Язык: русский, english

Отличия от версии 1.0.1:
- Исправлена ошибка, возникающая при использовании плагина в топиках форума

Отличия от версии 1.0.0:
- Совместимость с PHP 5.3
- Исправлена ошибка: на некоторых хостах не в url не ставился слеш после доменного имени.

Требования:
- jQuery
- PHP библиотека CURL должна быть установлена на Вашем сервере

Установка:
- распаковать архив
- папку «weather» скопировать на сервер в папку «plugins»
- установить и настроить в панеле администратора.
- в файл скина «header.tpl» или «footer.tpl» добавить тег {WEATHER}

Плагин тестировался с Cotonti Genoa 0.6.7

Обсудить на форуме.

Cotonti. Права на создание страниц

Sat, 26 Dec 2009 03:16:00 +0300

Данный плагин позволяет отделить права на создание страниц от прав на их редактирование.

Этот плагин анализирует в правах пользователя опцию "Extra 3" установленную для категорий. Если включено, то пользователи этой группы могут добавлять новые страницы в данную категорию. Вы можете настраивать это для каждой категории в разделе настройки прав пользователя, пройдя по ссылке "подробно" внизу страницы.

Если в данной категории создание страниц для пользователя не разрешено, то дабы не смущать его такой возможностью, ему не будет показана ссылка "Создать новую страницу".

Например, страницы может создавать только администратор сайта, но он может их назначить другим пользователям, и каждый может редактировать только свои страницы.

Установка стандартна:
- распаковать архив
- скопировать папку "an_PageAddRights" на сервер в папку "plugins"
- установить из панели администратора

Опционально вы можете добавить строку в файл skins/your_skin/your_skin.ru.lang.php

$skinlang['admin']['addPage'] = 'Добавлять страницу (для страниц)'; // by Alex

в файле skins/your_skin/admin/admin.rightsbyitem.inc.tpl найти строку 66:

: {PHP.L.Custom} #3

заменить на:

: {PHP.skinlang.admin.addPage}

и в файле skins/your_skin/admin/admin.rights.inc.tpl найти строку 196:

: {PHP.L.Custom} #3

заменить на:

: {PHP.skinlang.admin.addPage}

Страница плагина на официальном сайте Cotonti.

Что такое Cotonti?

Cotonti — это расширяемая CMS/CMF на базе PHP/MySQL.
C одной стороны это система управления сайтом ( CMS ) с готовой структурой под типовой сайт, с другой стороны — очень простой и функциональный фреймворк ( CMF ).
Cotonti является преемником Seditio CMS, которая была создана на базе системы Land Down Under. В настоящее время она динамично развивается и совершенствуется, позволяя Web-мастерам решать самые разнообразные задачи.

Основные преимущества Cotonti:
- открытый исходный код
- скорость и безопасность
- низкая нагрузка на сервер.
- модульность и расширяемость при помощи плагинов.

Скачать последнюю версию можно на официальном сайте.

Lily Software

File System

Конфигурирование файловых систем.

Image bundle

Методы класса для работы с изображениями:

Cotonti - Files

{PHP.L.files_attachments}

{PHP.L.files_downloads}

Cotonti - Рассылки

/themes/your-theme/img/logo-small.png"> Новости от

Cotonti - Banners

Cotonti - Доска объявлений

Cotonti - Dictionary.

Cotonti - cPanel.

Для разработчиков:

Скриншоты:

Cotonti - Работа.

View. PHP-шаблонизатор.

Основные методы класса View:

SOM. (Simple Object Manipulation)

Общие сведения

Требования

Использование нескольких соединений с бд

Создание моделей

Связи между моделями

Основные методы класса Som_Model_Abstract

Получение объектов

Условия для выборки

Валидаторы. Проверка объектов.

Сеттеры и Геттеры

Loader. Загрузчик

Cotonti. Alpha Filters

Установка

7. Экстраполя

6. Производители

4. Валюта

5. Налогоги и правила расчета цен

Cotonti. Region-City ajax selector

3. Редактирование товара

2. Способы оплаты и доставки

1. Установка

Cotonti. Онлайн-консультант.

Cotonti - SecurImage CAPTCHA (Каптча)

Joomla module. AN Carousel.

Joomla module. VirtueMart. AN VM Accordion

Cotonti. Blogger.

Cotonti. Print, PDF Version, E-mail to friend

Cotonti. Плагин прогноза погоды.

Cotonti. Права на создание страниц