Встраивание Mahjong Solitaire на ваш сайт или блог

Мы рады представить новую функцию на TheMahjong.com. Теперь вы можете встроить игру Маджонг пасьянс прямо на свой сайт или блог. Неважно, ведёте ли вы небольшой личный блог, игровой портал или страницу о головоломках и тренировке мозга — ваши посетители смогут играть прямо у вас на сайте.

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

Зачем мы добавили функцию встраивания

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

Для встраивания игры на ваш сайт, не нужно менять код. Она работает как небольшой автономный блок, который встаёт в нужном вам месте. Вам нужно только добавить на страницу небольшой фрагмент кода, а остальное мы берём на себя: игра загружается с наших серверов, остаётся актуальной и работает так же, как на TheMahjong.com.

Два способа встроить Mahjong Solitaire

Есть два простых способа добавить Маджонг пасьянс на ваши страницы:

• iframe. Работает почти на любом сайте;
• oEmbed. Поддерживается многими популярными системами управления контентом (CMS).

В обоих случаях пользователи видят одну и ту же игру. Отличается только способ её добавления на страницу.

Вариант 1: простое встраивание через iframe

Вариант с iframe даёт вам небольшой HTML-фрагмент, который можно вставить в код страницы. Это хорошо подходит, если вы можете редактировать HTML сайта или если в редакторе есть блок для пользовательского кода.

Типичный пример встраивания через iframe выглядит так:

<iframe 
  src="https://themahjong.com/shared-game" 
  title="Mahjong game" 
  loading="lazy" 
  allowFullScreen 
  style="width:100%;height:600px;border:none">
</iframe>

Вы можете:

• разместить этот блок там, где хотите показать игру;
• изменить значение width в процентах, чтобы игра подстраивалась под ширину контейнера;
• изменить значение height в пикселях, чтобы вписать игру в макет вашей страницы.

Если вы хотите поддержать TheMahjong.com, вы можете добавить небольшую текстовую ссылку на наш сайт рядом со встроенной игрой. Это не обязательно, но мы всегда это ценим.

Вариант 2: oEmbed для CMS-платформ

Если ваш сайт работает на CMS с поддержкой oEmbed (например, WordPress, Drupal или Joomla с подходящими плагинами), вы можете использовать встраивание без прямой работы с HTML-кодом iframe.

Каждая страница «Поделиться» содержит URL раскладки и oEmbed-код.

Некоторые редакторы могут автоматически превращать URL раскладки во встроенную игру. Вы просто вставляете URL в блок, который поддерживает встраиваемый контент. В других случаях система может попросить вас вставить oEmbed-код в специальное поле или блок, который предоставляет тема или плагин.

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

Где встраивание особенно хорошо работает

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

• Тематические записи и статьи в блогах. Если вы пишете о головоломках, настольных, расслабляющих играх, встроенный расклад логично разместить рядом с текстом в виде небольшого интерактивного примера. Выберите раскладку, которая хоть как-то связана с темой материала, чтобы игра не казалась чужеродной.
• Разделы с играми и головоломками на сайте. На сайтах, где уже есть раздел «Игры» или «Головоломки», встроенная игра в маджонг может быть одним из основных элементов страницы, а не просто ссылкой. Это хорошо работает и для небольших личных проектов, и для крупных порталов, которые хотят добавить ещё одну классическую головоломку, не разрабатывая её с нуля.
• Страницы о памяти, внимании и тренировках. Статьи о концентрации, распознавании образов или простых ежедневных упражнениях для мозга могут только выиграть от примера, в который можно сразу поиграть. Маджонг пасьянс хорошо подходит как спокойная, ненавязчивая активность, которую читатели могут попробовать сразу, без установки чего-либо и не покидая страницу.
• Странички, приуроченные к определённым датам. Для сезонного контента (осенние темы, зимние праздники, местные фестивали) можно встраивать раскладки, которые усиливают настроение страницы. Например, раскладка со знаком зодиака для ежедневного астрологического прогноза. Тематический расклад рядом с основным текстом помогает странице выглядеть более завершённой и даёт посетителям дополнительный повод задержаться.
• Разделы тематических сайтов и форумов. На сайтах сообществ, форумах и внутренних командных порталах часто есть простые страницы вроде «сделать перерыв» или «сыграть минутку». Встроенный расклад маджонга органично вписывается как небольшая самостоятельная мини-игра, которая не требует регистрации или скачивания.

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

Встроенная игра загружается по HTTPS с TheMahjong.com. Она использует тот же код и те же ресурсы, что и основной сайт, поэтому скорость работы сопоставима: как только игра кэшируется, раскладки должны быстро загружаться при повторных посещениях.

Если вы встраиваете игру с использованием атрибута loading="lazy" в iframe, большинство браузеров будут откладывать её загрузку до тех пор, пока пользователь не прокрутит страницу к области с игрой. Это помогает странице оставаться отзывчивой, особенно если на ней несколько встроенных игр.

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