Files
site_users/site_users.install
Quintino A. G. Souza 8bab0515e1 feat: Adiciona field type social_link para redes sociais do usuário
Implementa o field type 'social_link' com seletor de rede e URL de
perfil, composto por:

- SocialLinkItem: field type com colunas 'network' (varchar 64) e
  'url' (varchar 2048), cardinalidade ilimitada
- SocialLinkWidget: widget com select de rede e input de URL
- SocialLinkFormatter: formatter que renderiza links com classe CSS
  por rede (social-link--{network}), target _blank e rel noopener
- config/optional: field.storage e field.field para user
- config/translations/pt-br: tradução do label e description
- hook_install e update_10002: configura form/view displays
- UserInfoBlock: expõe social_links via getSocialLinks()
- Template: adiciona seção de redes sociais e remove referências
  obsoletas a category e dept_code
- translations/site_users.pt-br.po: strings do novo field type

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-23 14:10:28 -03:00

290 lines
8.1 KiB
Plaintext

<?php
/**
* @file
* Install, update and uninstall functions for the Site Users module.
*/
use Drupal\Core\Entity\Entity\EntityFormDisplay;
use Drupal\Core\Entity\Entity\EntityViewDisplay;
use Drupal\field\Entity\FieldConfig;
use Drupal\field\Entity\FieldStorageConfig;
/**
* Implements hook_install().
*/
function site_users_install() {
// Configurar form display para os campos de usuário.
$form_display = EntityFormDisplay::load('user.user.default');
if ($form_display) {
// Campo Nome.
if (!$form_display->getComponent('field_user_name')) {
$form_display->setComponent('field_user_name', [
'type' => 'string_textfield',
'weight' => 10,
'settings' => [
'size' => 60,
'placeholder' => '',
],
'region' => 'content',
]);
}
// Campo Telefone.
if (!$form_display->getComponent('field_user_phone')) {
$form_display->setComponent('field_user_phone', [
'type' => 'telephone_default',
'weight' => 11,
'settings' => [
'placeholder' => '',
],
'region' => 'content',
]);
}
// Campo Fotos - Media Library widget.
if (!$form_display->getComponent('field_user_photos')) {
$form_display->setComponent('field_user_photos', [
'type' => 'media_library_widget',
'weight' => 14,
'settings' => [
'media_types' => [],
],
'region' => 'content',
]);
}
// Campo Biografia.
if (!$form_display->getComponent('field_user_bio')) {
$form_display->setComponent('field_user_bio', [
'type' => 'text_textarea',
'weight' => 15,
'settings' => [
'rows' => 5,
'placeholder' => '',
],
'region' => 'content',
]);
}
// Campo Redes Sociais.
if (!$form_display->getComponent('field_user_social_links')) {
$form_display->setComponent('field_user_social_links', [
'type' => 'social_link_widget',
'weight' => 16,
'settings' => [],
'region' => 'content',
]);
}
// Campo Foto Padrão - oculto no form (será gerenciado via hook_form_alter).
$form_display->removeComponent('field_user_default_photo');
$form_display->save();
}
// Configurar view display para os campos de usuário.
$view_display = EntityViewDisplay::load('user.user.default');
if ($view_display) {
// Campo Nome.
if (!$view_display->getComponent('field_user_name')) {
$view_display->setComponent('field_user_name', [
'type' => 'string',
'weight' => 10,
'label' => 'above',
'settings' => [
'link_to_entity' => FALSE,
],
'region' => 'content',
]);
}
// Campo Telefone.
if (!$view_display->getComponent('field_user_phone')) {
$view_display->setComponent('field_user_phone', [
'type' => 'telephone_link',
'weight' => 11,
'label' => 'above',
'settings' => [
'title' => '',
],
'region' => 'content',
]);
}
// Campo Fotos.
if (!$view_display->getComponent('field_user_photos')) {
$view_display->setComponent('field_user_photos', [
'type' => 'entity_reference_entity_view',
'weight' => 14,
'label' => 'above',
'settings' => [
'view_mode' => 'default',
'link' => FALSE,
],
'region' => 'content',
]);
}
// Campo Biografia.
if (!$view_display->getComponent('field_user_bio')) {
$view_display->setComponent('field_user_bio', [
'type' => 'text_default',
'weight' => 15,
'label' => 'above',
'settings' => [],
'region' => 'content',
]);
}
// Campo Redes Sociais.
if (!$view_display->getComponent('field_user_social_links')) {
$view_display->setComponent('field_user_social_links', [
'type' => 'social_link_formatter',
'weight' => 16,
'label' => 'above',
'settings' => [],
'region' => 'content',
]);
}
// Campo Foto Padrão.
if (!$view_display->getComponent('field_user_default_photo')) {
$view_display->setComponent('field_user_default_photo', [
'type' => 'entity_reference_entity_view',
'weight' => 5,
'label' => 'hidden',
'settings' => [
'view_mode' => 'default',
'link' => FALSE,
],
'region' => 'content',
]);
}
$view_display->save();
}
}
/**
* Adiciona o campo field_user_default_photo para seleção de foto padrão.
*/
function site_users_update_10001() {
// Criar field storage se não existir.
if (!FieldStorageConfig::loadByName('user', 'field_user_default_photo')) {
FieldStorageConfig::create([
'field_name' => 'field_user_default_photo',
'entity_type' => 'user',
'type' => 'entity_reference',
'settings' => [
'target_type' => 'media',
],
'cardinality' => 1,
'translatable' => FALSE,
])->save();
}
// Criar field instance se não existir.
if (!FieldConfig::loadByName('user', 'user', 'field_user_default_photo')) {
FieldConfig::create([
'field_name' => 'field_user_default_photo',
'entity_type' => 'user',
'bundle' => 'user',
'label' => 'Default Photo',
'description' => 'Select the main profile photo.',
'required' => FALSE,
'settings' => [
'handler' => 'default:media',
'handler_settings' => [
'target_bundles' => [
'image' => 'image',
],
'sort' => [
'field' => '_none',
'direction' => 'ASC',
],
'auto_create' => FALSE,
'auto_create_bundle' => '',
],
],
])->save();
}
// Configurar view display.
$view_display = EntityViewDisplay::load('user.user.default');
if ($view_display && !$view_display->getComponent('field_user_default_photo')) {
$view_display->setComponent('field_user_default_photo', [
'type' => 'entity_reference_entity_view',
'weight' => 5,
'label' => 'hidden',
'settings' => [
'view_mode' => 'default',
'link' => FALSE,
],
'region' => 'content',
])->save();
}
// Ocultar do form display (será gerenciado via hook_form_alter).
$form_display = EntityFormDisplay::load('user.user.default');
if ($form_display) {
$form_display->removeComponent('field_user_default_photo')->save();
}
return t('Default photo field created successfully.');
}
/**
* Adds the field_user_social_links field for social network profile links.
*/
function site_users_update_10002() {
// Create field storage if it does not exist.
if (!FieldStorageConfig::loadByName('user', 'field_user_social_links')) {
FieldStorageConfig::create([
'field_name' => 'field_user_social_links',
'entity_type' => 'user',
'type' => 'social_link',
'module' => 'site_users',
'cardinality' => -1,
'translatable' => FALSE,
])->save();
}
// Create field instance if it does not exist.
if (!FieldConfig::loadByName('user', 'user', 'field_user_social_links')) {
FieldConfig::create([
'field_name' => 'field_user_social_links',
'entity_type' => 'user',
'bundle' => 'user',
'label' => 'Social Links',
'description' => 'Social network profile links.',
'required' => FALSE,
])->save();
}
// Add to form display.
$form_display = EntityFormDisplay::load('user.user.default');
if ($form_display && !$form_display->getComponent('field_user_social_links')) {
$form_display->setComponent('field_user_social_links', [
'type' => 'social_link_widget',
'weight' => 16,
'settings' => [],
'region' => 'content',
])->save();
}
// Add to view display.
$view_display = EntityViewDisplay::load('user.user.default');
if ($view_display && !$view_display->getComponent('field_user_social_links')) {
$view_display->setComponent('field_user_social_links', [
'type' => 'social_link_formatter',
'weight' => 16,
'label' => 'above',
'settings' => [],
'region' => 'content',
])->save();
}
return t('Social links field created successfully.');
}