它能做什么
护照通行力是互联网上被分享最多的旅行统计数据。现有小组件要么把你锁进付费墙，要么只给一个没有任何解释的数字。Orizn 护照评分小组件通过两行嵌入代码，为读者提供完整的 4 维细分、全球排名、可分享评分卡以及对比差值。
每本护照的得分是四个维度的加权综合——免签入境、落地签、电子签、须赴使馆——权重经过设计以反映真实的旅行摩擦。底层数据与签证查询小组件同源：39 601 个护照-目的地组合，每晚由 200+ 官方使馆数据源核对更新。
小组件完全自挂载。把两行代码放到任意位置，想预填就设置 data-passport（否则小组件根据访客地区推断），就这么简单。没有初始化函数、没有 React Provider、不需要 API key。兼容所有主流 CMS，gzip 后 12 KB，自带可通过 50/50 分成变现的指南购买 CTA。
小组件构建器
下方的小组件运行的正是你将粘贴到自己网站上的生产脚本。每个选项都会即时更新预览和代码——语言、主题、颜色、白标——调好后复制两行代码即可。
Live preview · updates as you type
The widget above runs the exact production script you would paste on your own site — async, zero dependencies, scoped CSS. Every option on the left maps to a data-* attribute in the snippet.
功能特性
具体、有数据来源的功能——不是空泛的勾选项。以下每一条今天都已在生产版小组件中上线。
完整覆盖 ISO 3166-1 alpha-3。每本护照以综合通行力得分与其他护照排名，签证政策一变，评分每晚随之刷新。
不止一个数字：小组件把通行力拆成四个维度——免签数量、落地签、电子签、须赴使馆。读者能看懂一本护照为何排在那个位置。
点击“查看前 10 名”即可滑出可排序的榜单。非常适合榜单类内容的互动。
访客选定护照后，小组件会显示与全球平均值的差值。真实、具体的语境——不只是一个数字。
一键生成 1200×630 的 PNG 评分卡，含访客的护照、排名和 4 条维度条。可直接发到 X、Instagram 或 LinkedIn。
未设置 data-passport 时，回退到根据访客浏览器推断的国籍。他们第一眼看到的就是自己的评分。
护照选择器以母语显示国名（Deutschland、日本 等），访客即使在外语页面浏览也能快速找到自己的护照。
套件中最轻的小组件。初始 JSON 加载后无任何外部请求，无分析像素，无字体加载。
最佳场景
小组件是通用的，但以下四类用户使用最多。只要你符合其中任何一类，粘贴代码后几分钟内就能见效。
在每个项目页（加勒比、马耳他、葡萄牙）嵌入。潜在客户立即看到该护照相对其现有护照的通行力回报。
放进欢迎邮件的网页版。比较旗帜理论选项的订阅者得到的是实时、有来源的评分，而不是一张 2022 年的亨利指数旧截图。
用小组件替换你的静态排名表。数据永远新鲜，文章无需手动更新就能在搜索结果中排名更久。
嵌入国家信息框内。一段代码即可让数百个页面都拥有一目了然的“护照实力”统计。
数据从何而来
通行力评分基于 Orizn 签证图谱计算：39 601 个护照-目的地组合，每晚由 200+ 官方使馆数据源、IATA 和政府新闻稿核对更新。综合权重（免签 1.0、落地签 0.8、电子签 0.6、使馆签 0.2）在 /docs/score-methodology 有完整文档，且跨版本保持稳定，便于跨期对比。
参考
每个选项都是容器 div 上的一个 data-* 属性。无需任何 JavaScript 配置——粘贴、设置想要的属性、上线。
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
data-passport | ISO3 | "" | 预填访客的护照（如 FRA、USA、DEU）。访客可自行更改。 |
data-lang | string | "auto" | 覆盖浏览器语言自动检测。支持 16 种语言：en、fr、es、de、it、pt、ja、ko、zh、ru、ar、hi、th、vi、tl、tr（阿拉伯语以 RTL 呈现）。 |
data-theme | string | "auto" | 强制主题："auto"（跟随系统）、"light" 或 "dark"。 |
data-color | hex | #2563EB | 评分仪表盘、排名徽章、维度条和 CTA 的强调色。仅接受十六进制色值（会做安全过滤）。 |
data-branding | string | "on" | 设为 "off" 即可白标：隐藏“Powered by Orizn”页脚、JSON-LD 结构化数据以及分享文案中的 orizn.app 字样。 |
data-radius | int | 16 | 小组件卡片和输入框的圆角半径（px）。 |
data-font | string | "system-ui" | 整个小组件使用的字体族。任何 CSS 字体栈均可。 |
集成
同样的两行代码，不同技术栈的粘贴路径略有差异。各 CMS 的分步指南：
变现
在容器 div 上添加 data-affiliate="ORIZN-XXXXX" 即可——ORIZN-… 和 aff_… 两种代码格式均可。读者通过小组件购买的每份指南在点击后 30 天内归因到你，收益每月通过 Stripe 结算。无最低门槛、无追回条款，联盟后台数据完全透明。
常见问题
来自集成小组件的开发者、博主和联盟营销者的真实问题。如果没找到你的问题，/embed/getting-started 的文档覆盖了更长尾的内容。
相关小组件
五个小组件共享同一运行时，因此在页面上再加一个不产生任何额外开销。整个套件就是为组合而设计的。