Как пользоваться

Короткая справка по всему, что умеет Hubcore Bio. Если что-то непонятно — посмотри примеры ниже, они собраны ровно из тех же блоков и настроек.

Примеры страниц

Блоки и раскладка

  • 17 типов блоков: ссылки, соцсети, галерея, видео, карта, формы, таймер, QR и другие.
  • Раскладка «Вертикально» — классическая лента. «Бенто» — сетка из 12 колонок: тяни блок за правый край и меняй ширину, или задай её кнопками ⅓ / ½ / ⅔ / 1.
  • Вкладки делят страницу на разделы («Ссылки / Магазин / Обо мне»). Заводятся кнопкой над списком блоков: переключил вкладку — список показывает только её блоки, и новый блок добавится туда же. Перенести готовый блок можно перетаскиванием прямо на нужную вкладку или кнопкой с её названием на карточке блока. Вкладки появляются у посетителей, начиная с двух.
  • У ширины отдельное значение для телефона: то, что на десктопе стоит в две колонки, на мобильном может занимать всю строку.
  • Порядок блоков на телефоне тоже свой — перетащи их в мобильном режиме превью.

Оформление

  • 18 готовых тем. Поверх темы можно задать свой фон: цвет, градиент, картинку или видео.
  • Декоративный узор (сетка, точки, сияние, звёзды, линии) ложится поверх фона. Цвет узора по умолчанию подбирается под тему, но его можно задать вручную.
  • Любой шрифт с Google Fonts через поиск, скругление углов одним ползунком на все блоки сразу и анимация появления.
  • Если не хватает — во вкладке «Дизайн» есть поле для своего CSS без ограничений.

Правила показа

  • У каждого блока есть свои правила — раскрой «Правила показа» в его настройках.
  • Период: блок появляется и исчезает сам в заданные дату и время.
  • Страны: показывать только в перечисленных или, наоборот, везде кроме них.
  • Подписка на Telegram-канал: блок открывается только тем, кто реально подписан. Нужно добавить @hubcoreorgbot администратором в канал — без этого Telegram не даст ему проверять подписчиков.
  • Скрыть блок можно и просто глазом в списке — он останется со всеми настройками, но пропадёт со страницы.

Аналитика и A/B

  • Просмотры по дням, страны и устройства — без внешних счётчиков.
  • Клики по каждому блоку отдельно, чтобы видеть, что реально работает.
  • У кнопки-ссылки можно задать несколько вариантов текста. Каждому посетителю показывается один и запоминается за ним, а в аналитике видно, какой собирает больше кликов.

Живые интеграции

  • «Сейчас слушаю» — Spotify по кнопке подключения, либо Last.fm по нику. Настройка Last.fm расписана отдельным разделом ниже.
  • «Топ треков» умеет брать данные из четырёх источников: Last.fm, Spotify, Яндекс Музыки (по открытому плейлисту, без токена) и YouTube (по плейлисту).
  • Если музыка не играет, блок показывает последний прослушанный трек.
  • Статус стрима на Twitch и YouTube: красный LIVE появляется сам, пока эфир идёт, и проверяется каждые полторы минуты.
  • YouTube-блок умеет показывать последнее видео с канала, а не только конкретную ссылку.

Свой домен

  • Во вкладке «Профиль» впиши свой домен и поставь у регистратора CNAME на bio.hubcore.org.
  • Домен должен быть за Cloudflare с включённым проксированием — HTTPS-сертификат выпускает он, отдельно ничего настраивать не нужно.
  • В настройках SSL у Cloudflare выбери режим Full. На Flexible и Full (strict) страница не откроется.
  • Изменения DNS расходятся до нескольких часов. В настройках есть кнопка проверки.

Настройка Last.fm

Last.fm сам ничего не проигрывает — он только записывает, что ты слушаешь в других приложениях. Это называется скробблинг. Поэтому одного аккаунта мало: нужно ещё подключить к нему свой плеер, иначе блок останется пустым. Ровно эта же инструкция есть в редакторе, прямо в настройках блока, вместе с кнопкой проверки.

  1. 1

    Завести аккаунт

    Регистрация на last.fm/join. В блок вписывается ник из адреса профиля: last.fm/user/ник. Не почта и не отображаемое имя.
  2. 2

    Подключить источник музыки

    Способ зависит от того, где ты слушаешь:
    • Spotify — подключается штатно и в один клик: last.fm/settings/applications → Spotify → Connect. Дальше считается всё, включая телефон и колонку.
    • Яндекс Музыка, YouTube Music, VK, SoundCloud, Deezer — своей интеграции с Last.fm у них нет, нужен посредник. В браузере это расширение Web Scrobbler: ставится в Chrome или Firefox, один раз авторизуется в Last.fm, дальше в его настройках включаются нужные сайты.
    • Телефон — на Android почти всё покрывает Pano Scrobbler, включая Яндекс Музыку и YT Music. На iOS официальное приложение Last.fm считает Apple Music.
    • Плееры на компьютере — у foobar2000, AIMP, MusicBee и VLC есть свои плагины, искать в настройках по слову Scrobbler.
  3. 3

    Открыть историю прослушиваний

    В last.fm/settings/privacy должна быть снята галочка «Hide recent listening information». Она закрывает историю не только от людей, но и от API: с ней блок будет пустым при полностью рабочем скробблинге. Это самая частая причина «ничего не показывает».
  4. 4

    Дать статистике накопиться

    «Сейчас слушаю» заработает с первого же трека. Топ считается по истории, поэтому на свежем аккаунте выбирай период «Всё время» — за неделю там пока нечего показывать. Свой топ Last.fm пересчитывает раз в сутки, так что только что прослушанное поднимется в списке не сразу.
Если блок пустой — почти всегда виновата закрытая история (шаг 3) или скробблер, который так и не отправил ни одного трека. Открой настройки блока в редакторе и нажми «Проверить, что всё настроено»: проверка скажет, видно ли аккаунт и есть ли в нём прослушивания.

Свой CSS

У страницы есть готовые классы, за которые можно зацепиться:

.bio-page      /* вся страница */
.bio-avatar    /* аватар */
.bio-username  /* @адрес */
.bio-bio-text  /* описание под именем */
.bio-blocks    /* контейнер блоков */
.bio-block     /* один блок */
.bio-tabs      /* переключатель вкладок */

/* только блоки нужного типа: */
[data-block-type="link"] { ... }

Частые вопросы

Можно ли поменять адрес страницы?

Да, раз в 90 дней. Адрес общий с аккаунтом HubCore ID, поэтому меняется он там же — в разделе «Профиль».

Сколько блоков можно добавить?

Без ограничений.

LIVE не загорается, хотя стрим идёт

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

Блок с подпиской не открывается у подписчиков

Скорее всего @hubcoreorgbot не добавлен администратором в канал. В настройках блока есть кнопка «Проверить» — она это покажет.

«Сейчас слушаю» пустой

Для Spotify нужно нажать «Подключить» в настройках блока. Для Last.fm — вписать ник и убедиться, что скробблер отправляет туда треки.

Не нашёл ответа — пиши в телеграм.