Merge branch 'main' of https://github.com/bitrix-tools/b24-rest-docs

Author: vk-bitrix-doc

.yfm

@@ -8,4 +8,10 @@ resources:
     - _assets/b24loc.js?20240925-02
     - _assets/b24addons.js?20241208-01
 
-search: true
+search: true
+
+extensions:
+  - './extensions/feedback-control'
+
+feedbackControl:
+  endpoint: https://util.1c-bitrix.ru/rest-doc/feedback-control.php

extensions/feedback-control/index.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Extension = void 0;
+const node_assert_1 = require("node:assert");
+const node_path_1 = require("node:path");
+const program_1 = require("@diplodoc/cli/lib/program");
+const cli_1 = require("@diplodoc/cli");
+class Extension {
+	apply(program) {
+		(0, program_1.getHooks)(program).Config.tap('FeedbackControl', (config) => {
+			if (!config.feedbackControl || "boolean" === typeof config.feedbackControl) {
+				return config;
+			}
+			(0, node_assert_1.ok)(config.feedbackControl.endpoint !== '', 'feedbackControl.endpoint must be not empty');
+			return config;
+		});
+		(0, cli_1.getBuildHooks)(program).BeforeRun.for('html').tap('FeedbackControl', (run) => {
+			if (!program.config.feedbackControl) {
+				return;
+			}
+			(0, cli_1.getEntryHooks)(run.entry).Page.tap('FeedbackControl', (template) => {
+				const controlConfig = program.config.feedbackControl === true ? {} : program.config.feedbackControl;
+				template.addScript('_extensions/feedback-control-extension.js', {
+					position: 'leading',
+					attrs: {
+						defer: void 0
+					}
+				});
+				template.addScript(`window.feedbackControlExtensionInit(${JSON.stringify(controlConfig)})`, {
+					position: 'state',
+					inline: true,
+				});
+			});
+		});
+		(0, cli_1.getBuildHooks)(program).AfterRun.for('html').tapPromise('FeedbackControl', async (run) => {
+			if (!program.config.feedbackControl) {
+				return;
+			}
+			const extensionFilePath = (0, node_path_1.join)(__dirname, 'resources', 'feedback-control-extension.js');
+			try {
+				await run.copy(extensionFilePath, (0, node_path_1.join)(run.output, '_extensions', 'feedback-control-extension.js'));
+			}
+			catch (error) {
+				run.logger.warn(`Unable copy the feedback-control extension script ${extensionFilePath}.`, error);
+			}
+		});
+	}
+}
+exports.Extension = Extension;

extensions/feedback-control/resources/feedback-control-extension.js

@@ -0,0 +1,46 @@
+"use strict";
+window.feedbackControlExtensionInit = (options) => {
+	const diplodocDataRef = window.__DATA__;
+	if (diplodocDataRef.data.leading) {
+		return;
+	}
+	options = Object.assign({}, { endpoint: void 0 }, options);
+	const route = window.location.pathname;
+	const storageKey = `feedback:${route}`;
+	const sendData = async (data) => {
+		await fetch(options.endpoint, {
+			method: 'POST',
+			headers: {
+				'Content-Type': 'application/json;charset=utf-8'
+			},
+			body: JSON.stringify({
+				route,
+				...data
+			})
+		});
+	};
+	const sendLocalState = (data) => {
+		if (data.type === 'indeterminate') {
+			window.localStorage.removeItem(storageKey);
+			return;
+		}
+		window.localStorage.setItem(storageKey, JSON.stringify(data));
+	};
+	const getLocalState = () => {
+		const data = window.localStorage.getItem(storageKey);
+		return data ? JSON.parse(data) : null;
+	};
+	const localState = getLocalState();
+	if ((localState === null || localState === void 0 ? void 0 : localState.type) === 'like') {
+		diplodocDataRef.data.isLiked = true;
+	}
+	if ((localState === null || localState === void 0 ? void 0 : localState.type) === 'dislike') {
+		diplodocDataRef.data.isDisliked = true;
+	}
+	diplodocDataRef.data.onSendFeedback = (data) => {
+		sendLocalState(data);
+		if (options.endpoint !== void 0) {
+			void sendData(data);
+		}
+	};
+};