For AI agents: the complete documentation index is available at /rspress-russian/llms.txt, the full documentation bundle is available at /rspress-russian/llms-full.txt, and this page is available as Markdown at /rspress-russian/plugin/community-plugins/third-party.md.
close

rspress-plugin-third-parties

Этот плагин предоставляет компоненты для YouTube, Twitter/X и Google Карт, интеграции с Google Analytics и Google Tag Manager, а также компонент Script для управления моментом загрузки скриптов.

Заметка

Это интеграция, поддерживаемая сообществом.

Установка

npm
yarn
pnpm
bun
deno
npm add rspress-plugin-third-parties -D

Глобальная аналитика

Чтобы добавить Google Analytics на все страницы, зарегистрируйте плагин в rspress.config.ts и замените G-XXXXXXXXXX на ваш идентификатор отслеживания GA4:

rspress.config.ts
import { defineConfig } from '@rspress/core';
import { pluginThirdParties } from 'rspress-plugin-third-parties/plugin';

export default defineConfig({
  plugins: [
    pluginThirdParties({
      googleAnalytics: { gaId: 'G-XXXXXXXXXX' },
    }),
  ],
});

Чтобы отслеживать клиентские переходы между страницами, настройте измерение одностраничных приложений в GA4.

Компоненты

Импортируйте компоненты в MDX-страницу или собственную тему. В примерах YouTube и Tweet ниже живой предпросмотр показан рядом с исходным кодом.

<YouTubeEmbed />

Показывает миниатюру видео и загружает YouTube-плеер при нажатии кнопки воспроизведения.

import { YouTubeEmbed } from 'rspress-plugin-third-parties';

<YouTubeEmbed
  videoid="sSbDtQTtwBY"
  playlabel="Digital Tamizh - A Lineage of Logic, A Future of Code (Unreal Engine Showcase)"
/>

<TweetEmbed />

Встраивает публикацию Twitter/X и подстраивается под светлую или тёмную тему сайта.

import { TweetEmbed } from 'rspress-plugin-third-parties';

<TweetEmbed id="2017178323550605790" />

<GoogleMapsEmbed />

Встраивает Google Карты. Чтобы использовать этот пример, замените плейсхолдер вашим ключом Google Maps Embed API.

import { GoogleMapsEmbed } from 'rspress-plugin-third-parties';

<GoogleMapsEmbed
  apiKey="YOUR_GOOGLE_MAPS_API_KEY"
  mode="place"
  q="Point Pedro, Sri Lanka"
  height={400}
/>

<Script />

Загружает внешние или встроенные скрипты и устраняет повторную загрузку внешних скриптов при переходах между страницами. Стратегия по умолчанию — afterInteractive; с lazyOnload загрузка откладывается, пока страница не загрузится, а браузер не перейдёт в состояние простоя.

import { Script } from 'rspress-plugin-third-parties';

<Script src="https://example.com/widget.js" strategy="lazyOnload" />

<GoogleTagManager />

Добавьте Google Tag Manager в макет вашей собственной темы.

import { GoogleTagManager } from 'rspress-plugin-third-parties';

<GoogleTagManager gtmId="GTM-XXXXXXX" />

<GoogleAnalytics />

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

import { GoogleAnalytics } from 'rspress-plugin-third-parties';

<GoogleAnalytics gaId="G-XXXXXXXXXX" />

После настройки Google Analytics используйте sendGAEvent в обработчике событий, чтобы отправлять пользовательские события:

import { sendGAEvent } from 'rspress-plugin-third-parties';

sendGAEvent('event', 'documentation_feedback', { sentiment: 'yes' });