| 1 |
# Gianism |
| 2 |
|
| 3 |
Contributors: Takahashi_Fumiki, hametuha |
| 4 |
Tags: facebook,twitter,google,instagram,account,oauth,community,social,sns |
| 5 |
Requires at least: 4.7 |
| 6 |
Tested up to: 5.6 |
| 7 |
Stable tag: 4.4.0 |
| 8 |
Requires PHP: 5.6 |
| 9 |
License: GPL 2.0 or later |
| 10 |
License URI: https://www.gnu.org/licenses/gpl-2.0.html |
| 11 |
|
| 12 |
Connect user accounts with major web services like Facebook, twitter, etc. Stand on the shoulders of giants! |
| 13 |
|
| 14 |
## Description |
| 15 |
|
| 16 |
This plugin enables your users to login/register with major Web service's accounts. Below is supported services. |
| 17 |
|
| 18 |
If your site needs user's login action, **signing-up is the most difficult step**. With this plugin, users can sign up without inputting email nor password. |
| 19 |
|
| 20 |
### Log in Flow Video |
| 21 |
|
| 22 |
https://youtu.be/JXl3EMPmXkY |
| 23 |
|
| 24 |
### Supported Web services |
| 25 |
|
| 26 |
* [](https://www.facebook.comFacebook](https://www.facebook.com](https://www.facebook.com) |
| 27 |
* [](https://twitter.comTwitter](https://twitter.com](https://twitter.com) |
| 28 |
* [](https://google.comGoogle](https://google.com](https://google.com) |
| 29 |
* [](https://instagram.comInstagram](https://instagram.com](https://instagram.com) |
| 30 |
* [](https://line.meLINE](https://line.me](https://line.me) *NEW* since 3.2.0 |
| 31 |
|
| 32 |
### Acknowledgements |
| 33 |
|
| 34 |
* Use [](https://github.com/abraham/twitteroauthAbraham Williams' twitteroauth](https://github.com/abraham/twitteroauth](https://github.com/abraham/twitteroauth). |
| 35 |
* Use [](https://github.com/facebook/facebook-php-sdkFacebook's official PHP SDK](https://github.com/facebook/facebook-php-sdk](https://github.com/facebook/facebook-php-sdk). |
| 36 |
* Use [](http://code.google.com/p/google-api-php-client/Google API PHP Client](http://code.google.com/p/google-api-php-client/](http://code.google.com/p/google-api-php-client/). |
| 37 |
* Use [](http://kudakurage.com/ligature_symbols/Ligature Symbols](http://kudakurage.com/ligature_symbols/](http://kudakurage.com/ligature_symbols/) (Web font). |
| 38 |
|
| 39 |
Gianism awes a lot to these open source projects. Thanks lots! |
| 40 |
|
| 41 |
## Installation |
| 42 |
|
| 43 |
Install itself is easy. Auto install from admin panel is recommended. Search with `gianism`. |
| 44 |
|
| 45 |
1. Donwload and unpack plugin file, upload `gianims` folder to `/wp-content/plugins` directory. |
| 46 |
2. Activate it from admin panel. |
| 47 |
|
| 48 |
### Use latest source on github |
| 49 |
|
| 50 |
You can get this plugin from [](https://github.com/fumikito/Gianism/github](https://github.com/fumikito/Gianism/](https://github.com/fumikito/Gianism/). Clone it and run `composer install && npm install && npm start`. About composer and npm, google it. |
| 51 |
|
| 52 |
### How to set up |
| 53 |
|
| 54 |
After plugin's activation, you have to set it up. Every setup has 2 step. One is on SNS, the other is on your site. |
| 55 |
|
| 56 |
For example, if you use Facebook, register new app on Facebook, then input app ID and token on WordPress admin panel. Every SNS requires **registeration of Apps** and **credentials related to it**. |
| 57 |
|
| 58 |
For more details, please refer to setting screen's instruction or our site [](https://gianism.info/gianism.info](https://gianism.info/](https://gianism.info/). |
| 59 |
|
| 60 |
## Frequently Asked Questions |
| 61 |
|
| 62 |
> Can I use this in English? |
| 63 |
|
| 64 |
Maybe yes. Translations are welcomed. |
| 65 |
|
| 66 |
> Found bug. It sucks. |
| 67 |
|
| 68 |
Sorry for that. Please refer to our support site [](http://wordpress.org/support/plugin/gianismgianism.info](http://wordpress.org/support/plugin/gianism](http://wordpress.org/support/plugin/gianism) or send pull request to [](https://github.com/fumikito/Gianism/repository on Github](https://github.com/fumikito/Gianism/](https://github.com/fumikito/Gianism/). |
| 69 |
|
| 70 |
## Screenshots |
| 71 |
|
| 72 |
1. Buttons on Login/registration screen. |
| 73 |
2. Show connection status on profile screen. Registered users can connect account here. |
| 74 |
3. Suit to plugins which customize login screen, e.g. [](http://wordpress.org/extend/plugins/theme-my-login/Theme My Login](http://wordpress.org/extend/plugins/theme-my-login/](http://wordpress.org/extend/plugins/theme-my-login/). |
| 75 |
|
| 76 |
## Changelog |
| 77 |
|
| 78 |
Here is a list of change logs. |
| 79 |
|
| 80 |
### 4.4.0 |
| 81 |
|
| 82 |
* Support [](https://wordpress.org/plugins/simple-membership/Simple Membership](https://wordpress.org/plugins/simple-membership/](https://wordpress.org/plugins/simple-membership/) plugin. You need to turn on **"Enable Auto Create Member Accounts"** and **"Force WP User Syncronization"**. |
| 83 |
* Supported multiple `to` in `wp_mail`. If `wp_mail` try to send email to multiple users with array of emails, Gianism filter psedudo email. Thanks [](https://github.com/fumikito/Gianism/pull/105@yutaka12](https://github.com/fumikito/Gianism/pull/105](https://github.com/fumikito/Gianism/pull/105)! |
| 84 |
|
| 85 |
### 4.3.4 |
| 86 |
|
| 87 |
* Add filter to customize login button order. |
| 88 |
* Add 2 short codes `gianism_login` and `gianism_connection` to display SNS buttons in public pages. |
| 89 |
* Add new function `gianism_connection` to display SNS connection buttons for logged in users. |
| 90 |
|
| 91 |
### 4.3.3 |
| 92 |
|
| 93 |
* Fix child site redirection on failuer under network site. |
| 94 |
* Fix redirect users to My Account if WooCommerce is activated. |
| 95 |
|
| 96 |
### 4.3.2 |
| 97 |
|
| 98 |
* Fix fatal error caused if WooCommerce is activated. |
| 99 |
|
| 100 |
### 4.3.1 |
| 101 |
|
| 102 |
* Fix informal message "Oops". |
| 103 |
|
| 104 |
### 4.3.0 |
| 105 |
|
| 106 |
* Support network activation. |
| 107 |
|
| 108 |
### 4.2.2 |
| 109 |
|
| 110 |
* Fix Cookie related bugs in PHP 7.3 and over. |
| 111 |
|
| 112 |
|
| 113 |
### 4.2.0 |
| 114 |
|
| 115 |
* Add profile completion options. Now you can notify users or redirect users to profile page if they have incomplete information(e.g. Wrong email). For more details, see [](https://gianism.info/2020/09/08/complete-user-profile/our blog post](https://gianism.info/2020/09/08/complete-user-profile/](https://gianism.info/2020/09/08/complete-user-profile/). |
| 116 |
|
| 117 |
### 4.1.0 |
| 118 |
|
| 119 |
* "Add friend" button for [](https://developers.line.biz/en/docs/line-login/link-a-bot/#getting-the-friendship-status-of-the-user-and-the-line-official-accountLINE](https://developers.line.biz/en/docs/line-login/link-a-bot/#getting-the-friendship-status-of-the-user-and-the-line-official-account](https://developers.line.biz/en/docs/line-login/link-a-bot/#getting-the-friendship-status-of-the-user-and-the-line-official-account) if you have an official account. |
| 120 |
|
| 121 |
### 4.0.0 |
| 122 |
|
| 123 |
4.0 is major update. Please check the changes. |
| 124 |
|
| 125 |
* **BREAKING CHANGE** Requires PHP 5.6 and higher. |
| 126 |
* **BREAKING CHANGE** PHP Session is not required anymore. Now Gianism uses Cookie instead. Therefore, please check Cookie's name below are passed to PHP. On environments under CDN like Amazon Cloudfront, Cookies are filtered with a whitelist. |
| 127 |
* `gianism_session` |
| 128 |
* `gianism_updated` |
| 129 |
* `gianism_error` |
| 130 |
* If possible, allow cookie prefixed `gianism_` for future updates. |
| 131 |
* All Cookie headers have now new property `SameSite=Lax`. |
| 132 |
* URL prefix for redirect URI is now available. Since previous version, Ginanism's endpoints are at root(e.g. `example.com/facebook`). Now you can add prefix as you like(e.g. `example.com/gianism/facebook`). Sorry for late update, but I was young. |
| 133 |
* Facebook API version update is very frequent, so Gianims ensure minimum API version. Gianism 4.0 igonres Facebook API version less than 6.0. |
| 134 |
* Remove unused libraries of Google PHP API Client from Gianism, because the library sizes are too huge. This may break your site if you use Google's library in your custom code. To check remaining libraries, refer `bin/composer-fixer.php`. |
| 135 |
* Some small fixes. |
| 136 |
|
| 137 |
---- |
| 138 |
|
| 139 |
Please refer [](https://github.com/fumikito/Gianism/blob/master/changelog.mdchangelog.md](https://github.com/fumikito/Gianism/blob/master/changelog.md](https://github.com/fumikito/Gianism/blob/master/changelog.md) for older change logs, |
