# ===========================================================================

# NG CMS // Плагины // Социальные закладки | Social Bookmarks

# ===========================================================================

## Описание плагина

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

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

В шаблоне новости (news.full.tpl):

```twig
{{ plugin_social }}
```

## Переменные шаблона (Twig)

### social.tpl

Основной шаблон, содержащий список всех сервисов.

**Переменные:**

- `home` - URL главной страницы сайта
- `entries` - массив объектов сервисов

### Объект сервиса (entry)

Каждый элемент массива `entries` содержит:

- `url` - полная ссылка на сервис с параметрами
- `title` - заголовок новости
- `desc` - описание сервиса (название кнопки)
- `img` - URL иконки сервиса
- `has_img` - true/false, есть ли иконка

**Пример шаблона:**

```twig
{% if entries %}
<div class="social-bookmarks">
    <ul class="social-list">
    {% for entry in entries %}
        <li class="social-item">
            <a href="{{ entry.url }}" title="{{ entry.desc }}" target="_blank">
                {% if entry.has_img %}
                    <img src="{{ entry.img }}" alt="{{ entry.title }}" />
                {% else %}
                    {{ entry.desc }}
                {% endif %}
            </a>
        </li>
    {% endfor %}
    </ul>
</div>
{% endif %}
```

## Настройка в админ-панели

1. **Общие настройки:**
   - Источник шаблонов (сайт/плагин)
   - Выбор скина оформления
   - Кеширование (вкл/выкл)
   - Время кеширования
   - Интеграция с bit.ly для сокращения URL

2. **Список сервисов:**
   - Добавление/редактирование сервисов
   - Активация/деактивация
   - Настройка URL с параметрами
   - Выбор иконки

3. **Параметры URL сервисов:**
   - `%title%` - заголовок новости (urlencoded)
   - `%content%` - краткое содержание до 200 символов (urlencoded)
   - `%link%` - URL новости, может быть сокращен через bit.ly (urlencoded)

## Предустановленные сервисы

При нажатии кнопки "Восстановить" добавляются:

- Twitter
- Facebook
- ВКонтакте
- Одноклассники
- LiveJournal
- Blogger
- Я.ру
- Мой круг
- Мой мир
- del.icio.us
- Digg
- StumbleUpon
- Google Bookmarks
- Yahoo MyWeb

**Примечание:** Некоторые сервисы (Google Buzz, Yahoo MyWeb) устарели и могут не работать.

## Интеграция с bit.ly

Для сокращения URL через bit.ly:

1. Зарегистрируйтесь на https://bit.ly
2. Получите API ключ
3. В настройках плагина укажите:
   - **Login** - ваш логин bit.ly
   - **API Key** - API ключ
   - Включите опцию интеграции

**Внимание:** Используется bit.ly API v2.0.1 (старая версия).
С новыми аккаунтами может не работать.

## Кеширование

Плагин поддерживает кеширование сгенерированного HTML.

- Включается в настройках плагина
- Настраивается время жизни кеша
- Кеш очищается автоматически при изменении настроек
- Кеш можно очистить вручную кнопкой "Очистить кеш"

## Пути к иконкам

Иконки могут храниться в двух местах:

1. **В теме сайта:**
   `templates/[СКИН]/plugins/social/images/`

2. **В плагине:**
   `engine/plugins/social/tpl/skins/[СКИН]/images/`

Приоритет: сначала проверяется тема сайта, затем скин плагина, затем default.

## Требования

- NG CMS (Next Generation CMS)
- Twig 2.x/3.x
- PHP 7.4+

## Версия

v0.22 - мигрировано на Twig, обновлены пути и функции

## Авторы

- **Оригинальный автор:** Dzmitry Khadorkin (KhadeR)
- **Сайт:** http://khadersg.com/me
- **Email:** khadorkin@gmail.com
- **Миграция на Twig:** AI Assistant (2026)

---

**Основано на плагинах:**

- Social.Rus (http://formazon.com)
- Aquaticus.Social (jwloh01@gmail.com)
