Extension:GoogleLogin/tr

GoogleLogin uzantısı, viki kullanıcılarının Google hesaplarıyla oturum açmalarına izin verir. Uzantı, Google'dan temel profil bilgilerini (hesap kimliği, tam ad ve e-posta adresi gibi) istemek için Google API'sini kullanır.

Gereksinimler
Bu uzantıyı kullanmak için en azından şunlara ihtiyacınız var:


 * MediaWiki 1.31+
 * MySQL (Şimdilik PostgreSQL veya SQLite desteği yok!)
 * PHP 5.6+
 * Google Geliştirici Erişimi
 * Web Uygulaması için API Kimlik Bilgileri (İstemci Kimliği ve İstemci Sırrı)
 * çalıştırabilir

Yapılandırma
Uzantı, İstemci Kimliğini ve İstemci Sırrını ayarlamak için iki yapılandırma değişkeni sağlar (bu çifti Google Geliştirici Konsolu'nda alırsınız, "<" ve ">" öğesini kaldırırsınız).

Google Geliştirici Konsolu'ndaki ayarlar
Bu uzantıyı kullanmak için bir Google geliştirici hesabına ve geliştirici konsoluna erişmeniz gerekir. Bu basit (çok basit!) bir adım adım kılavuzdur:


 * 1) Google geliştirici konsolunu açın
 * 2) Hizmet şartlarını okuyun ve kabul edin
 * 3) Create your first project
 * 4) APIS & AUTH gidin
 * 5) Credentials gidin
 * 6) OAuth bölümünde, Create new Client ID tıklayın
 * 7) Web application ile APPLICATION TYPE, ile Authorized JavaScript origins alanınıza yazarak seçin (joker karakterlere ve dizine izin verilmez!)
 * 8) Bu örneği gibi Authorized redirect URI yazın:
 * Etki alanınız example.com ise ve etki alanınızın Köküne MediaWiki yüklediyseniz, yönlendirme URI'si aşağıdaki gibidir: http://example.com/index.php/Special:GoogleLoginReturn
 * 1) Oluşturun ve Client ID ve Client Secret ile LocalSettings.php'deki yapılandırma değişkenlerine kopyalayın.

"Special:GoogleLoginReturn" veya (Almancada örnek) "Spezial:GoogleLoginReturn"
Google geliştirici konsolunda izin verilen yönlendirme URI'sı içerik dilinde olmalıdır. Dolayısıyla, vikinizin içerik dili olarak Almanca varsa,  kullanın. Yanlış dili kullandıysanız, tüm kimlik doğrulama istekleri "uri uyuşmazlığını yeniden yönlendirme" hata koduyla başarısız olur.

Hata ayıklama
Normalde, hata mesajını tüm genel hata sayfalarında görebilirsiniz. Bazen İstisnalar adı verilen Dahili Hatalar vardır. Bu durumda, İstisna mesajının tamamını görmek için lütfen LocalSettings.php'ye "true" değeriyle ekleyin. Destek talebi için lütfen daima İstisna satırlarını sağlayın.

Özel bir vikide kullanın
Vikinizi özel olarak ayarladıysanız

"Special:GoogleLoginReturn" sayfasını beyaz listeye eklemeniz gerekir, böylece anonim kullanıcılar kimlik doğrulama sağlayıcısından yeniden yönlendirildikten sonra geri arama URL'sine erişebilir. Bunu, LocalSettings.php dosyanıza aşağıdaki satırı ekleyerek yapabilirsiniz:

Vikide izin verilen etki alanlarını yönetin
GoogleLogin, Google ile girişi belirli e-posta adresi alanlarıyla (gmail.com, googlemail.com veya diğer her (kendi) etki alanı gibi) kısıtlamak için bir özellik sağlar. Bu özellik, özellikle kendi alan adlarını Google Apps ile kullanan şirketler için ilginçtir. Google ile oturum açmasına izin verilen etki alanlarının listesi LocalSettings.php'de ( yapılandırma seçeneği) bir dizide yönetilir. 0.4.0 sürümünden bu yana, GoogleLogin ayrıca vikinin kendisinde izin verilen etki alanlarının listesini yönetmek için bir yol sağlar. İzin verilen alanlar, bu özellik etkinleştirildiğinde veritabanına kaydedilir ve bir grafik kullanıcı arabirimi (özel bir sayfa) veya MediaWiki API'si aracılığıyla değiştirilebilir (kaldır/ekle).

Not: Veritabanındaki etki alanlarının yönetimi etkinleştirildikten sonra, izin verilen etki alanlarının listesi artık LocalSettings.php'de yönetilemez.

Özelliğin veritabanında izin verilen etki alanlarını yönetmesini sağlamak için LocalSettings.php dosyanızda  yapılandırma değişkenini   olarak ayarlamanız yeterlidir. Ayrıca yeni  kullanıcı hakkını üyesi olduğunuz bir gruba atamak istiyorsunuz (bu kullanıcı hakkına sahip tüm kullanıcıların izin verilen alan adları listesini değiştirmesine izin verildiğini lütfen unutmayın, bu hakkı yalnızca hizmetli düzeyindeki bir gruba eklemeyi düşünün!). Örnek bir yapılandırma şöyle görünebilir:

Şimdi, gerekli veritabanı değişikliklerinin veritabanınıza uygulanması için  betiğini yeniden çalıştırmanız gerekir. Güncelleme işlemi tamamlandıktan sonra, vikinizde  özel sayfasına gidebilirsiniz. Google hesaplarıyla oturum açmalarına izin verilen ve eklendikten sonra bunları kaldırabileceğiniz yeni etki alanları ekleyebileceğiniz bir sayfa alacaksınız.

$wgGLAPIKey
Bu yapılandırma seçeneği hala mevcuttur, ancak artık Special:ManageGoogleLogin özel sayfasından daha fazlası için kullanılmaktadır. Artık, kullanıcının doğru Google hesabını tanımlamasını kolaylaştırmak için Special:RemoveCredentials sayfasında bir kullanıcının adını almak için kullanılıyor (yalnızca Google kimliğini göstermek yerine). Anahtar doğru değilse veya sağlanmadıysa, GoogleLogin yalnızca Google kimliğini gösterecektir. İyi bir kullanıcı deneyimi için, bu API anahtarını şimdi sağlamanız şiddetle tavsiye edilir.

Yetkili modu
Google Login, etkinleştirildiğinde, oturum açmak için kullanılan Google hesabı halihazırda yerel bir MediaWiki hesabıyla ilişkilendirilmediğinde bir kullanıcı hesabının otomatik olarak oluşturulduğu yetkili modu destekler. Bu seçenek varsayılan olarak devre dışıdır ve bir yapılandırma seçeneğiyle etkinleştirilmesi gerekir. Ancak, bunu yapmadan önce lütfen aşağıdaki önemli bilgileri okuyun. Bu özellik, viki yapılandırmasının aşağıdakileri kesinlikle desteklemesini gerektirir:


 * GoogleLogin'in tek birincil kimlik doğrulama sağlayıcısı olması gerekir
 * @ işareti  yapılandırmasında bryaz listeye eklenmesi gerek
 * Hesapların otomatik oluşturulması etkinleştirilmelidir:
 * GoogleLogin yetkili modunun etkinleştirilmesi gerekiyor

Enabling this feature also has the following influence:


 * The username of the account is the primary email field of the returned information from Google. This is not configurable.
 * If a local wiki account is already connected, this account is used to login, which means that an already existing account takes precedence over creating a new one.
 * The new created account will automatically being linked with the Google account.
 * GoogleLogin will not let a user add or remove any further Google account connections (or the automatically created link) to prevent a user from being not able to login anymore.
 * GoogleLogin does not add a password during the account creation, if the authoritative mode is disabled and password login shall be enabled again, the user needs to reset their password.

Google API PHP Client
This Extension uses the Google API PHP Client (included in versions before 0.2.1), distributed under the Apache 2.0 License. The Client can be downloaded from GitHub.

updatePublicSuffixArray.php
The  maintenance script downloads a list of domain names which are valid to be used in the world. This is required in order for GoogleLogin to allow subdomains of a specific email domain when you've restricted the login with GoogleLogin for specific domains. This is only needed if  is set to false (which is the default).

Version lifecycle
Please note that I support only the latest version of GoogleLogin. Any versions apart from the current release (which means the current MediaWiki release branch) and the current development version (aka master) are not supported anymore.