Extension:ContactPage/ru

Справка по расширениям MediaWiki

ContactPage Статус релиза: стабильно
Реализация	Служебная страница , Хук
Описание	Предоставляет контактную форму для посетителей
Автор(ы)	Daniel Kinzler, Sam Reed
Последняя версия	Continuous updates
Политика совместимости	Snapshots releases along with MediaWiki. Master is not backward compatible.
MediaWiki	>= 1.42.0
PHP	5.4+
Изменения в БД	Нет
Лицензия	GNU General Public License 2.0 или позднее
Скачать	Скачать расширение Git [?]: скачать текущую версию исходника репозиторий (Phabricator · GitHub) история изменений список разработчиков (GitHub) code review README
Пример	nl.wikipedia.org
Параметры $wgContactConfig
Предоставляемые хуки ContactForm ContactFromComplete
Ежеквартальные загрузки	74 (Ranked 74th)
Переведите расширение ContactPage, если оно доступно на translatewiki.net
Роль Vagrant	contactpage
Проблемы	Открытые задачи · Сообщить об ошибке

Расширение ContactPage реализует контактную форму для посетителей. Он создает специальную страницу "Special:Contact", которая похожа на "Special:EmailUser", но имеет фиксированного получателя и может использоваться без регистрации.

Установка и настройка

• Скачайте и распакуйте файл(ы) в папку с названием ContactPage в вашей папке extensions/.
  Вместо этого разработчикам и соавторам кода следует установить расширение из Git, используя:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/ContactPage
• Добавьте следующий код в конце вашего файла LocalSettings.php :

  wfLoadExtension( 'ContactPage' );
  $wgContactConfig['default'] = [
  	'RecipientUser' => 'WikiUser',  // Must be the name of a valid account which also has a verified e-mail-address added to it.
  	'SenderName' => 'Contact Form on ' . $wgSitename,  // "Contact Form on" needs to be translated
  	'SenderEmail' => null,  // Defaults to $wgPasswordSender, may be changed as required
  	'RequireDetails' => true,  // Either "true" or "false" as required
  	'IncludeIP' => true, // Either "true" or "false" as required
  	'MustBeLoggedIn' => true,  // Check if the user is logged in before rendering the form. Either "true" or "false" as required
      'NameReadonly' => false, // Set to "true" to make the name field read only
      'EmailReadonly' => false, // Set to "true" to make the email address field read only
      'SubjectReadonly' => false, // Set to "true" to make the subject line field read only
      'MustHaveEmail' => false, // Set to "true" to require that the user submitting the form must have an associated email address
  	'AdditionalFields' => [
  		'Text' => [
  			'label-message' => 'emailmessage',
  			'type' => 'textarea',
  			'rows' => 20,
  			'required' => true,  // Either "true" or "false" as required
  		],
  	],
  	'DisplayFormat' => 'table',  // See HTMLForm documentation for available values.
  	'RLModules' => [],  // Resource loader modules to add to the form display page.
  	'RLStyleModules' => []  // Resource loader CSS modules to add to the form display page.
  ];
  

• See the README file for further options to customize and adapt as it convenes.
•  Готово – Перейдите на страницу Special:Version на своей вики, чтобы удостовериться в том, что расширение успешно установлено.

You can require a CAPTCHA test for the contact page, if you have the ConfirmEdit extension installed. CAPTCHAs are enabled by adding

$wgCaptchaTriggers['contactpage'] = true;

to "LocalSettings.php" below the invocation of both extensions.

Дальнейшая настройка

Adding a link to special page "Contact" to the footer

MediaWiki 1.37.0 or later

1. Add the following code without changing it to your "LocalSettings.php" file:

   $wgHooks['SkinAddFooterLinks'][] = function( Skin $skin, string $key, array &$footerlinks ) {
       if ( $key === 'places' ) {
           $footerlinks['contact'] = Html::element( 'a',
               [
                   'href' => 'https://www.example.org/wiki/Special:Contact',  // URL to "Special:Contact"
                   'rel' => 'noreferrer noopener'  // not required, but recommended for security reasons
               ],
           $skin->msg( 'contactpage-label' )->text()
           );
       };
   };
   

2. Add the label for "Special:Contact" to system message MediaWiki:Contactpage-label.

MediaWiki 1.36.x or earlier

1. Add the following code without changing it to your "LocalSettings.php" file:

   $wgHooks['SkinTemplateOutputPageBeforeExec'][] = function( $skin, &$template ) {
   	$contactLink = Html::element( 'a', [ 'href' => $skin->msg( 'contactpage-url' )->escaped() ],
   		$skin->msg( 'contactpage-label' )->text() );
   	$template->set( 'contact', $contactLink );
   	$template->data['footerlinks']['places'][] = 'contact';
   	return true;
   };
   

2. Add the URL of "Special:Contact" to system message MediaWiki:Contactpage-url and
3. Add the label for "Special:Contact" to system message MediaWiki:Contactpage-label.

Creating complex forms

See HTMLForm and related pages for more information on the possibilities available to create more complex forms.

Проблемы

Users of some hosting providers such as SiteGround and Amazon SES may get a PHP mail error or one that says that the FROM email address is not configured in the server, despite $wgPasswordSender being configured correctly and other email functionality working as expected. A fix for this issue is described here.

См. также

• Extension:EmailPage - Позволяет отправлять полностью отрисованные статьи со встроенным CSS пользователям, группам или спискам контактов
• Extension:CIForms - Формы с автоматической проверкой, вопросами с множественным выбором и тестами cloze