README

稳定标签: 0.3.0
至少需要: 3.7
测试到: 5.9.1
需要PHP: 7.4
许可证: MIT
标签: pantheon, geolocation, shortcodes, edge integrations, agcdn, geoip, personalization
贡献者: jazzs3quence, getpantheon

与Pantheon WordPress Edge Integrations SDK一起使用，此插件允许站点使用短码显示地理位置内容。

存档项目

由于该项目不再接受积极开发，该项目已于2024年8月存档。此SDK中提供的工具和相关项目提供的架构仍然有效，并将在Pantheon AGCDN上继续工作。但是，我们不会响应问题或拉取请求，也不会构建比现有更多的这些工具。

描述

此插件允许您通过使用短码快速将地理位置内容添加到您的网站。

为了使地理位置内容出现在您的网站上，您必须是拥有在您的网站上启用了高级全球CDN的Pantheon客户。此外，您必须已经安装了Pantheon WordPress Edge Integrations插件。

安装

通过Composer安装

安装插件的建议方法是使用Composer。

composer require pantheon-systems/pantheon-geolocation-shortcodes

该软件包设置为wordpress-plugin，因此它应该与您的项目中的其他WordPress插件一起安装。

通过WordPress.org安装

从WordPress.org下载插件并将其上传到您的WordPress安装。在激活之前，请确保您已安装Pantheon WordPress Edge Integrations插件。如果没有找到，则此插件无法激活。

手动安装

插件也可以像普通插件一样手动安装。在发布页面上找到最新版本，并下载ZIP文件。

将ZIP文件的内容提取到您的wp-content/plugins目录中，然后上传或提交到您的服务器。

要求

此插件不安装Pantheon WordPress Edge Integrations SDK或Pantheon WordPress Edge Integrations插件。那些必须单独安装。虽然SDK不是显式依赖项，但WordPress Edge Integrations插件对于地理位置插件的功能是必需的。

此外，Pantheon高级全球CDN必须处于活动状态并配置为地理位置短码可以使用。

在使用Pantheon地理位置短码之前，应卸载或停用使用[geoip]短码的任何其他插件。

更新

插件更新取决于您是如何安装它的。如果您通过Composer安装了它，则可以根据您的版本约束条件通过Composer更新它。有关更多信息，请参阅版本和约束条件。

如果您是手动安装的插件，您可以通过在发布页面下载最新版本，并将ZIP文件的内容提取到您的wp-content/plugins目录中来进行更新。

如果您通过WordPress.org插件仓库安装了插件，则可以像其他插件更新一样正常安装更新。

使用方法

您可以使用以下短代码来显示基于访问者位置的地理定位内容

洲： [geoip-continent]，两位洲代码，例如“NA”
国家： [geoip-country]，两位国家代码，例如“US”
地区： [geoip-region]，两位地区代码，例如“CA”
城市： [geoip-city]，完整的城市名称，例如“San Francisco”
位置： [geoip-location]，城市、地区、国家的组合，如果所有信息都可用，例如“San Francisco, CA, US”

本地化内容

此外，您还可以使用geoip-content短代码对帖子中的内容应用逻辑。您可以使用上述任何参数来使用geoip-content短代码，并允许显式地排除位置。以下是您可以传递给geoip-content短代码的可用选项

continent
country
region
city
not_continent
not_country
not_region
not_city

示例

假设您只想向美国访客显示内容。您可以使用以下短代码

[geoip-content country="US"]This is content just for US visitors.[/geoip-content]

也许您只想向来自特定地区的访客显示内容。您可以使用以下短代码

[geoip-content region="CA, TX"]This is content exclusively for visitors from California and Texas.[/geoip-content]

您还可以混合使用地理和负地理选项来添加更复杂的逻辑。例如，如果您想向来自加利福尼亚州和德克萨斯州的访客显示内容，但不向来自洛杉矶的访客显示，您可以使用以下短代码

[geoip-content region="CA, TX" not_city="Los Angeles"]This is content for visitors from California and Texas, but not from Los Angeles.[/geoip-content]

重复的位置名称

如果您的地区中有多个位置具有相同的名称，您可能需要调整逻辑以确保向正确的访客显示正确的内容。例如，如果您想向来自美国、欧洲和澳大利亚的访客显示相同的内容，但想排除爱尔兰的Dublin，您就需要使用以下短代码

[geoip-content country="US, AU"]Fly to Dublin, Ireland for a weekend getaway for only $199![/geoip-content][geoip-content country="EU" not_city="Dublin"]Fly to Dublin, Ireland for a weekend getaway for only $199![/geoip-content]

pantheon-systems / pantheon-geolocation-shortcodes

维护者

详细信息