docs: add deprecated argument to plugin info

.dumi/theme/builtins/PluginInfo.tsx

@@ -1,77 +1,130 @@
 import { Link, useSiteData } from 'dumi';
 import React from 'react';
+import messages from '../locale/pluginInfo';
 
-function PluginLink(props) {
+interface PluginInfoProps {
+  name: string;
+  link?: string;
+  plugins?: string;
+  commercial?: boolean;
+  licenseBundled?: 'enterprise' | 'commercial' | boolean;
+  /** @deprecated This parameter is deprecated and will be removed in future versions. */
+  deprecated?: boolean;
+}
+
+function PluginLink(props: { name: string; link?: string }) {
   const { name, link } = props;
   return <Link to={link ?? `/handbook/${name}`}>plugin-{name}</Link>;
 }
 
-function PluginList({ plugins, name, link }) {
-  return plugins ? plugins.split(',').map((item, i) => (
+function PluginList({ plugins, name, link }: { plugins?: string; name: string; link?: string }) {
+  return plugins ? (
     <>
-      <PluginLink name={item} />
-      {i < plugins.split(',').length - 1 ? ', ' : ''}
+      {plugins.split(',').map((item, i) => (
+        <React.Fragment key={item}>
+          <PluginLink name={item.trim()} />
+          {i < plugins.split(',').length - 1 ? ', ' : ''}
+        </React.Fragment>
+      ))}
     </>
-  )) : <PluginLink name={name} link={link} />;
+  ) : (
+    <PluginLink name={name} link={link} />
+  );
 }
 
-const PluginInfo = (props) => {
-  const { name, link, plugins, commercial, licenseBundled } = props;
+function formatMessage(template: string, values: Record<string, React.ReactNode>) {
+  const parts = template.split(/(\{[^}]+\})/g);
+  return parts.map((part, index) => {
+    const matches = part.match(/\{([^}]+)\}/);
+    if (matches) {
+      const key = matches[1];
+      return <React.Fragment key={index}>{values[key]}</React.Fragment>;
+    }
+    return part;
+  });
+}
+
+const PluginInfo: React.FC<PluginInfoProps> = (props) => {
+  const { name, link, plugins, commercial, licenseBundled, deprecated } = props;
   const { themeConfig } = useSiteData();
-  const zhCN = themeConfig.lang === 'zh-CN';
-  const jaJP = themeConfig.lang === 'ja-JP';
-  const bundleTexts = licenseBundled === 'enterprise' ? {
-    'zh-CN': '企业版',
-    'ja-JP': '企业版',
-    'en-US': 'commercial edition',
-  } : {
-    'zh-CN': '商业版',
-    'ja-JP': '商业版',
-    'en-US': 'commercial edition',
-  }
+  const lang = themeConfig.lang || 'en-US';
+  const t = messages[lang];
+
+  const edition = licenseBundled && licenseBundled === 'enterprise' 
+    ? t.enterpriseEdition 
+    : t.commercialEdition;
+
+  const commercialLink = (text: string) => {
+    const paths = {
+      'zh-CN': '/cn/commercial',
+      'ja-JP': '/jp/commercial',
+      'en-US': '/en/commercial'
+    };
+
+    return (
+      <a target="_blank" rel="noreferrer" href={`${t.commercialBaseUrl}${paths[lang]}`}>
+        {text}
+      </a>
+    );
+  };
+
+  const licenseLink = () => {
+    const paths = {
+      'zh-CN': '/cn/plugins',
+      'ja-JP': '/jp/plugins',
+      'en-US': '/en/plugins'
+    };
+
+    return (
+      <a target="_blank" rel="noreferrer" href={`${t.commercialBaseUrl}${paths[lang]}`}>
+        {t.commercialLicense}
+      </a>
+    );
+  };
+
+  const pluginsList = <PluginList plugins={plugins} name={name} link={link} />;
+
+  const renderMessage = () => {
+    if (licenseBundled) {
+      return (
+        <span>
+          {formatMessage(t.bundledPluginMessage, {
+            plugins: pluginsList,
+            edition: commercialLink(edition)
+          })}
+        </span>
+      );
+    }
+
+    return (
+      <span>
+        {formatMessage(t.pluginMessage, {
+          commercial: commercial ? t.commercial : '',
+          plugins: pluginsList,
+          license: commercial ? formatMessage(t.licenseDetails, {
+            license: licenseLink()
+          }) : ''
+        })}
+      </span>
+    );
+  };
 
   return (
     <div>
-      <div className="dumi-default-container markdown" data-type="info">
-        <svg viewBox="64 64 896 896"><path d="M512 64C264.6 64 64 264.6 64 512s200.6 448 448 448 448-200.6 448-448S759.4 64 512 64zm0 820c-205.4 0-372-166.6-372-372s166.6-372 372-372 372 166.6 372 372-166.6 372-372 372z"></path><path d="M464 336a48 48 0 1 0 96 0 48 48 0 1 0-96 0zm72 112h-48c-4.4 0-8 3.6-8 8v272c0 4.4 3.6 8 8 8h48c4.4 0 8-3.6 8-8V456c0-4.4-3.6-8-8-8z"></path></svg>
-        <h4>
-          {zhCN ? '提示' : jaJP ? '注意' : 'INFO'}
-        </h4>
-        {
-          licenseBundled ? (
-            <section>
-              {zhCN ? (
-                <p>
-                  该功能由商业插件 <PluginList name={name} link={link} plugins={plugins} /> 提供，包含在 <a target="_blank" href="https://www.nocobase.com/cn/commercial">{bundleTexts[themeConfig.lang]}</a> 中，无需单独购买。
-                </p>
-              ) : jaJP ? (
-                <p>
-                  この機能は商用プラグイン <PluginList name={name} link={link} plugins={plugins} /> によって提供されます，包含在 <a target="_blank" href="https://www.nocobase.com/jp/commercial">{bundleTexts[themeConfig.lang]}</a> 中，无需单独购买。
-                </p>
-              ) : (
-                <p>
-                  This feature is provided by the commercial plugin <PluginList name={name} link={link} plugins={plugins} />, included in the <a target="_blank" href="https://www.nocobase.com/en/commercial">{bundleTexts[themeConfig.lang]}</a>, with no additional purchase required.
-                </p>
-              )}
-            </section>
-          ) : (
-            <section>
-              {zhCN ? (
-                <p>
-                  该功能由{commercial ? '商业' : ''}插件 <PluginList name={name} link={link} plugins={plugins} /> 提供{commercial && <>，请查看 <a target="_blank" href="https://www.nocobase.com/cn/plugins">商业授权</a> 了解详情</>}.
-                </p>
-              ) : jaJP ? (
-                <p>
-                  この機能は{commercial ? '商用' : ''}プラグイン <PluginList name={name} link={link} plugins={plugins} /> によって提供されます。{commercial && <> 詳細については、<a target="_blank" href="https://www.nocobase.com/jp/plugins">商用ライセンス</a> をご覧ください。</>}
-                </p>
-              ) : (
-                <p>
-                  This feature is provided by the {commercial ? 'commercial ' : ''}plugin <PluginList name={name} link={link} plugins={plugins} />. {commercial && <><br /> Please refer to the <a target="_blank" href="https://www.nocobase.com/en/plugins">commercial license</a> for details.</>}
-                </p>
-              )}
-            </section>
-          )
-        }
+      <div className="dumi-default-container markdown" data-type={deprecated ? 'warning' : 'info'}>
+        <svg viewBox="64 64 896 896">
+          <path d="M512 64C264.6 64 64 264.6 64 512s200.6 448 448 448 448-200.6 448-448S759.4 64 512 64zm0 820c-205.4 0-372-166.6-372-372s166.6-372 372-372 372 166.6 372 372-166.6 372-372 372z"></path>
+          <path d="M464 336a48 48 0 1 0 96 0 48 48 0 1 0-96 0zm72 112h-48c-4.4 0-8 3.6-8 8v272c0 4.4 3.6 8 8 8h48c4.4 0 8-3.6 8-8V456c0-4.4-3.6-8-8-8z"></path>
+        </svg>
+        <h4>{deprecated ? t.deprecatedInfo : t.info}</h4>
+        <section>
+          <p>{renderMessage()}</p>
+        </section>
+        {deprecated && (
+          <section>
+            <p>{t.deprecatedMessage}</p>
+          </section>
+        )}
       </div>
     </div>
   );

.dumi/theme/locale/pluginInfo.ts

@@ -0,0 +1,41 @@
+export default {
+  'zh-CN': {
+    info: '提示',
+    deprecatedInfo: '已废弃',
+    bundledPluginMessage: '该功能由商业插件 {plugins} 提供，包含在 {edition} 中，无需单独购买。',
+    commercialEdition: '商业版本',
+    pluginMessage: '该功能由{commercial}插件 {plugins} 提供。{license}',
+    commercial: '商业',
+    licenseDetails: '请查看{license}了解详情',
+    commercialLicense: '商业授权',
+    deprecatedMessage: '⚠️ 该功能已废弃，我们不建议在新项目中使用此功能。',
+    enterpriseEdition: '企业版',
+    commercialBaseUrl: 'https://www.nocobase.com'
+  },
+  'ja-JP': {
+    info: '注意',
+    deprecatedInfo: '非推奨',
+    bundledPluginMessage: 'この機能は商用プラグイン {plugins} によって提供されます，{edition} に含まれており、個別の購入は必要ありません。',
+    commercialEdition: '商用版',
+    pluginMessage: 'この機能は{commercial}プラグイン {plugins} によって提供されます。{license}',
+    commercial: '商用',
+    licenseDetails: '詳細については、{license}をご覧ください。',
+    commercialLicense: '商用ライセンス',
+    deprecatedMessage: '⚠️ この機能は非推奨となりました。新しいプロジェクトでの使用はお勧めしません。',
+    enterpriseEdition: '企業版',
+    commercialBaseUrl: 'https://www.nocobase.com'
+  },
+  'en-US': {
+    info: 'INFO',
+    deprecatedInfo: 'DEPRECATED',
+    bundledPluginMessage: 'This feature is provided by the commercial plugin {plugins}, included in the {edition}, with no additional purchase required.',
+    commercialEdition: 'commercial edition',
+    pluginMessage: 'This feature is provided by the {commercial}plugin {plugins}.{license}',
+    commercial: 'Commercial',
+    licenseDetails: 'For details, please check the {license}.',
+    commercialLicense: 'Commercial License',
+    deprecatedMessage: '⚠️ This feature is deprecated and not recommended for use in new projects.',
+    enterpriseEdition: 'enterprise edition',
+    commercialBaseUrl: 'https://www.nocobase.com'
+  }
+};

docs/en-US/handbook/backup-restore/index.md

@@ -1,6 +1,6 @@
 # Backup and Restore
 
-<PluginInfo name="backup-restore"></PluginInfo>
+<PluginInfo name="backup-restore" deprecated=true></PluginInfo>
 
 ## Introduction
 

docs/en-US/plugins/backup-restore/index.md

@@ -1,5 +1,5 @@
 # Backup-Restore
-
+<PluginInfo name="backup-restore" deprecated=true></PluginInfo>
 ## Introduction
 
 The backup-restore and restore plugin for the NocoBase application is used in scenarios such as application replication, migration, and upgrades.

docs/fr-FR/plugins/backup-restore/index.md

@@ -1,5 +1,5 @@
 # Backup and Restore
-
+<PluginInfo name="backup-restore" deprecated=true></PluginInfo>
 ## Introduction
 
 The backup and restore plugin for the NocoBase application is used in scenarios such as application replication, migration, and upgrades.

docs/ja-JP/handbook/backup-restore/index.md

@@ -1,6 +1,6 @@
 # バックアップと復元
 
-<PluginInfo name="plugin-manager"></PluginInfo>
+<PluginInfo name="backup-restore" deprecated=true></PluginInfo>
 
 ## 紹介
 

docs/zh-CN/handbook/backup-restore/index.md

@@ -1,6 +1,6 @@
 # 备份和还原
 
-<PluginInfo name="plugin-manager"></PluginInfo>
+<PluginInfo name="backup-restore" deprecated=true></PluginInfo>
 
 ## 介绍