跳至主要內容
  • 關於 WordPress
    • 關於 WordPress
    • WordPress.org 台灣繁體中文
    • 線上說明
    • 技術支援
    • 意見反應
  • 登入
  • 註冊
WordPress.org
WordPress.org

Taiwan 正體中文

  • 佈景主題目錄
  • 外掛目錄
  • 最新消息
  • 技術支援
  • 關於我們
  • 團隊
  • 取得 WordPress
取得 WordPress

外掛目錄

  • 我的最愛
  • Beta 版測試
  • 開發者資訊

這個外掛並未在最新的 3 個 WordPress 主要版本上進行測試。開發者可能不再對這個外掛進行維護或提供技術支援,並可能會與更新版本的 WordPress 產生使用上的相容性問題。

下載

XLogin

由 Patrick Lai 開發
  • 詳細資料
  • 使用者評論
  • 安裝方式
  • 技術支援
  • 開發資訊

外掛說明

XLogin enhances the WordPress login page (usually wp-login.php) to
allow users to authenticate with the following external services:

  • Facebook Login
  • Google Sign-In
  • Yahoo! OAuth

These services can be enabled or disabled individually. XLogin adds a
button to the WordPress login page for each enabled service. Clicking
the button sends the browser to the corresponding external service
where the user can authorize the WordPress site to access their
information. Having been granted access to, for example, the Facebook
public profile of a user, XLogin retrieves their email address to
find a matching WordPress user to complete the login process.

XLogin also maintains a list of external aliases. They are additional
email addresses for mapping to WordPress users. Some scenarios where
external aliases can be handy include:

  1. A user’s email address in his WordPress profile is not used in any
    of the external services. For example, a corporate WordPress site
    may mandate the use of company email addresses in user
    profiles. If a user has for example his Gmail address in the
    external alias list, they can still nevertheless sign in Google.

  2. A WordPress user account is shared by a group of actual
    users. With XLogin it is not necessary to have the users share a
    single password. Instead just register their email addresses (as
    known by the external services) as external aliases; it becomes a
    simple matter to add and remove user.

XLogin has the option to restrict an external service to only users with
external aliases. This allows tight control on who can use external
services to login.

A user’s profile in WordPress and in the external service may be
different. Email address is one, and display name (or its component
family and given names) is another. XLogin offers the option to import
the external profile information into the current session. The imported
display name will be tagged with the external service name. For
example, if a user has display name ‘John Doe’ in WordPress, but is
known as ‘Johnny D’ in his Facebook account, then he would be
displayed as ‘Johnny D (Facebook)’ (instead of ‘John Doe’) in his
WordPress session when he logs in with Facebook.

Finally XLogin has the notion of ‘guest’ user. When an email address
provided by an external service does not correspond to a specific
WordPress user, XLogin will proceed with a guest WordPress user
configured for the service. There are plugins that control access to
content based on user roles; a site can combine such with XLogin to
control what is visible to guests. Note that guest WordPress users
should have minimal privileges. XLogin has safeguards to ensure, for
example, that a guest cannot edit posts. It also filters out guest’s
permission to access the dashboard or to update their own profile.

螢幕擷圖

  • WordPress login page with buttons for external logins.
  • Display name of user imported from external service, e.g. Facebook.
  • XLogin settings page.
  • Configuration of OAuth2 based external service, e.g. Google. Note the redirect URI that should be added to the OAuth2 client configuration in the external service.
  • Add or update an external alias.
  • Upload CSV file of external aliases.

安裝方式

  1. Upload the plugin files to the ‘…/wp-content/plugins/xlogin’
    directory, or install the plugin through the ‘Plugin’s screen in
    WordPress.
  2. Activate the plugin.
  3. Configure external services for login on the Settings->XLogin page.
    • Enter configuration data for the external service. For an
      OAuth2 based service, that means client ID and client
      secret. Note that the redirect URI for OAuth2 is displayed here.
    • Set per-service options:
      • Restrict to users with external aliases.
      • Import profile information (email address and name) from
        external service into session.
    • Enable external services.
  4. Maintain external aliases on the Settings->XLogin page.
    • Aliases may be added/updated/deleted one at a time.
    • Filters may be applied to the list of aliases displayed.
    • Multiple aliases may be uploaded in a CSV file. Each line in the
      file contains an email address and a WordPress user name,
      separated by comma.

If WordPress permalinks are ‘plain’, one may need to configure the
web server to route callbacks from external service to WordPress
index.php script. For Apache that would mean rewrite rules in
.htaccess like theses:
RewriteEngine On
RewriteRule wp-content/plugins/xlogin/callback/ index.php [L]

常見問題集

Does this work with WordPress version X?

This plugin was originally developed with WordPress 5.3. It has been
tested to various extent up to 5.7.

Does this work with PHP 5.x?

No. This plugin uses various PHP 7.x features. Backporting to PHP 5.x
should not be difficult however.

How do I obtain client ID and secret to configure an OAuth2 based external service( e.g. Facebook)?

Here are some pointers:

  • Google. A project must first be set up. OAuth2 clients are
    managed on the API credentials page. Use an existing or
    create a new OAuth client, of ‘web application’ type.

  • Facebook. An ‘app’ must first be set up. Use the ‘App ID’ and
    ‘App Secret’ from the its basic settings page for client ID and
    secret respectively. Add Facebook Login to the product list of the
    app, and configures the redirect URI there.

  • Yahoo. A Yahoo app corresponds to an OAuth2 client. Make sure
    your app has email and profile permissions for OpenID Connect.

A user tries to login with Google, but gets sent back to the WordPress login page with a “Google user not recognized” error. What does this mean?

XLogin uses the email address provided by Google (or whatever external
service) to map to a WordPress user. Check the following:

  • Is the email address registered as an external alias in XLogin?

  • Does email address belong to a WordPress user profile? If so,
    make sure the external service is not configured as ‘restricted’.

The “*XYZ* user not recognized” error is confusing. Can the login page show only external login buttons that are applicable to the user?

Generally XLogin may not know anything about the user until the end of
authentication/authorization with the external service, so it would be
a challenge.

How does XLogin override the email and display name of a user?

This is rather technical, but is important for ongoing maintenance of
the plugin. This answer is intended for PHP developers working with
WordPress.

WordPress keeps track of the user of the current request in various PHP
global variables. XLogin installs a callback for the set_current_user
action to inject profile information from external service into them.
The action name and the global data structures may be specific to
WordPress versions; the file init.php and the PHP method
XLogin::importXUser() are expected to be modified to support more
WordPress versions.

Can XLogin be used for new user registration?

This is not supported currently.

Can XLogin support other external services?

XLogin uses the OAuth 2 Client from The League of
Extraordinary Packages. It should be straightforward to add an
additional OAuth2 based login service as long as a compatible
provider is available. See the list of providers.

使用者評論

這個外掛目前沒有任何使用者評論。

參與者及開發者

以下人員參與了開源軟體〈XLogin〉的開發相關工作。

參與者
  • Patrick Lai

將〈XLogin〉外掛本地化為台灣繁體中文版

對開發相關資訊感興趣?

任何人均可瀏覽程式碼、查看 SVN 存放庫,或透過 RSS 訂閱開發記錄。

變更記錄

1.1.2

  • Facebook Graph API version may be specified in customization settings.
  • Admin page built with Vue.js components that are bundled by webpack.js.
  • Miscellaneous bug fixes.

1.1.1

  • Miscellaneous bug fixes.

1.1

  • Custom message to display with external login buttons.
  • Guest user for unmatched email address.

1.0

  • First version published.

中繼資料

  • 最新版本: 1.1.2
  • 最後更新: 1 年前
  • 啟用安裝數: 少於 10 次
  • WordPress 版本需求: 5.3 或更新版本
  • 已測試相容的 WordPress 版本: 5.7.6
  • PHP 版本需求: 7.0 或更新版本
  • 語言:
    English (US)
  • 標籤:
    facebookgoogleloginoauthyahoo
  • 進階檢視

評分

這個外掛尚無任何評分記錄。

登入以提交評論

參與者

  • Patrick Lai

技術支援

使用者可在技術支援論壇提出意見反應或使用問題。

檢視技術支援論壇

  • 關於我們
  • 最新消息
  • 主機託管
  • 贊助基金會
  • 技術支援
  • 開發者資源
  • 共同參與
  • Learn
  • 展示網站
  • 外掛目錄
  • 佈景主題目錄
  • 區塊版面配置目錄
  • WordCamp
  • WordPress.TV
  • BuddyPress
  • bbPress
  • WordPress.com
  • Matt
  • 隱私權
  • Public Code
WordPress.org
WordPress.org

Taiwan 正體中文

  • 造訪我們的 Facebook 粉絲專頁
  • 造訪我們的 Twitter 帳號
程式碼,如詩