function ColorboxSettingsForm::buildForm

Same name and namespace in other branches

1. 8.x-1.x src/Form/ColorboxSettingsForm.php \Drupal\colorbox\Form\ColorboxSettingsForm::buildForm() 1 comment

File

src/Form/ColorboxSettingsForm.php, line 100

Class

ColorboxSettingsForm

General configuration form for controlling the colorbox behaviour..

Namespace

Drupal\colorbox\Form

Code

public function buildForm(array $form, FormStateInterface $form_state) {
    global $base_url;
    $module_path = $this->extensionListModule
        ->getPath('colorbox');
    $img_folder_path = $base_url . '/' . $module_path . '/images/admin';
    $config = $this->configFactory
        ->get('colorbox.settings');
    $dompurify = $this->libraryDiscovery
        ->getLibraryByName('colorbox', 'dompurify');
    $dompurify_file = !empty($dompurify['js'][0]['data']) ? DRUPAL_ROOT . '/' . $dompurify['js'][0]['data'] : NULL;
    $dompurify_exists = !empty($dompurify) && !empty($dompurify_file) && file_exists($dompurify_file);
    $form['colorbox_dompurify'] = [
        '#type' => 'details',
        '#title' => $this->t('DOMPurify Library'),
        '#open' => TRUE,
    ];
    $dompurify_message = $dompurify_exists ? $this->t('The DOMPurify library is installed. This library will sanitize HTML in Colorbox captions.') : $this->t('The <a href="@dompurify_link">DOMPurify</a> library is not installed. This library is necessary if you want to use HTML in Colorbox captions. Without it, all captions will be treated as plain text.', [
        '@dompurify_link' => 'https://github.com/cure53/DOMPurify/archive/main.zip',
    ]);
    $form['colorbox_dompurify']['dompurify_message'] = [
        '#type' => 'markup',
        '#prefix' => '<p>',
        '#suffix' => '</p>',
        '#markup' => $dompurify_message,
    ];
    if (!$dompurify_exists) {
        $form['colorbox_dompurify']['dompurify_hide_warning'] = [
            '#type' => 'checkbox',
            '#title' => t("Don't show warning on status report"),
            '#default_value' => $config->get('dompurify_hide_warning'),
            '#description' => t("By default, a warning appears on Drupal's status report if this library is missing. Check this box to suppress the warning."),
        ];
    }
    $form['colorbox_custom_settings'] = [
        '#type' => 'details',
        '#title' => $this->t('Styles and options'),
        '#open' => TRUE,
    ];
    $colorbox_styles = [
        'default' => $this->t('Default'),
        'plain' => $this->t('Plain (mainly for images)'),
        'stockholmsyndrome' => $this->t('Stockholm Syndrome'),
        'example1' => $this->t('Example 1'),
        'example2' => $this->t('Example 2'),
        'example3' => $this->t('Example 3'),
        'example4' => $this->t('Example 4'),
        'example5' => $this->t('Example 5'),
        'none' => $this->t('None'),
    ];
    $form['colorbox_custom_settings']['colorbox_style'] = [
        '#type' => 'select',
        '#title' => $this->t('Style'),
        '#options' => $colorbox_styles,
        '#default_value' => $config->get('custom.style'),
        '#description' => $this->t('Select the style to use for the Colorbox. The example styles are the ones that come with the Colorbox plugin. Select "None" if you have added Colorbox styles to your theme.  <br> <strong>Examples</strong>: <ul><li><a href="@img_folder_path/example_default.png" target="blank">Default</a></li><li><a href="@img_folder_path/example_plain.png" target="blank">Plain</a></li><li><a href="@img_folder_path/example_stockholm_syndrome.png" target="blank">Stockholm Syndrome</a></li><li><a href="@img_folder_path/colorbox_example_1.png" target="blank">Example 1</a></li><li><a href="@img_folder_path/colorbox_example_2.png" target="blank">Example 2</a></li><li><a href="@img_folder_path/colorbox_example_3.png" target="blank">Example 3</a></li><li><a href="@img_folder_path/colorbox_example_4.png" target="blank">Example 4</a></li><li><a href="@img_folder_path/example_none.png" target="blank">None</a></li></ul>', [
            '@img_folder_path' => $img_folder_path,
        ]),
    ];
    $form['colorbox_custom_settings']['colorbox_custom_settings_activate'] = [
        '#type' => 'radios',
        '#title' => $this->t('Options'),
        '#options' => [
            0 => $this->t('Default'),
            1 => $this->t('Custom'),
        ],
        '#default_value' => $config->get('custom.activate'),
        '#description' => $this->t('Use the default or custom options for Colorbox.'),
    ];
    $form['colorbox_custom_settings']['colorbox_transition_type'] = [
        '#type' => 'radios',
        '#title' => $this->t('Transition type'),
        '#options' => [
            'elastic' => $this->t('Elastic'),
            'fade' => $this->t('Fade'),
            'none' => $this->t('None'),
        ],
        '#default_value' => $config->get('custom.transition_type'),
        '#description' => $this->t('The transition type.'),
        '#states' => $this->getState(static::STATE_CUSTOM_SETTINGS),
    ];
    $form['colorbox_custom_settings']['colorbox_transition_speed'] = [
        '#type' => 'select',
        '#title' => $this->t('Transition speed'),
        '#options' => $this->optionsRange(100, 600, 50),
        '#default_value' => $config->get('custom.transition_speed'),
        '#description' => $this->t('Sets the speed of the fade and elastic transitions, in milliseconds.'),
        '#states' => $this->getState(static::STATE_CUSTOM_SETTINGS),
    ];
    $form['colorbox_custom_settings']['colorbox_opacity'] = [
        '#type' => 'select',
        '#title' => $this->t('Opacity'),
        '#options' => $this->optionsRange(0, 1, 0.05),
        '#default_value' => $config->get('custom.opacity'),
        '#description' => $this->t('The overlay opacity level. Range: 0 to 1.'),
        '#states' => $this->getState(static::STATE_CUSTOM_SETTINGS),
    ];
    $form['colorbox_custom_settings']['colorbox_text_current'] = [
        '#type' => 'textfield',
        '#title' => $this->t('Current'),
        '#default_value' => $config->get('custom.text_current'),
        '#size' => 30,
        '#description' => $this->t('Text format for the content group / gallery count. {current} and {total} are detected and replaced with actual numbers while Colorbox runs.'),
        '#states' => $this->getState(static::STATE_CUSTOM_SETTINGS),
    ];
    $form['colorbox_custom_settings']['colorbox_text_previous'] = [
        '#type' => 'textfield',
        '#title' => $this->t('Previous'),
        '#default_value' => $config->get('custom.text_previous'),
        '#size' => 30,
        '#description' => $this->t('Text for the previous button in a shared relation group.'),
        '#states' => $this->getState(static::STATE_CUSTOM_SETTINGS),
    ];
    $form['colorbox_custom_settings']['colorbox_text_next'] = [
        '#type' => 'textfield',
        '#title' => $this->t('Next'),
        '#default_value' => $config->get('custom.text_next'),
        '#size' => 30,
        '#description' => $this->t('Text for the next button in a shared relation group.'),
        '#states' => $this->getState(static::STATE_CUSTOM_SETTINGS),
    ];
    $form['colorbox_custom_settings']['colorbox_text_close'] = [
        '#type' => 'textfield',
        '#title' => $this->t('Close'),
        '#default_value' => $config->get('custom.text_close'),
        '#size' => 30,
        '#description' => $this->t('Text for the close button. The "Esc" key will also close Colorbox.'),
        '#states' => $this->getState(static::STATE_CUSTOM_SETTINGS),
    ];
    $form['colorbox_custom_settings']['colorbox_maxwidth'] = [
        '#type' => 'textfield',
        '#title' => $this->t('Max width'),
        '#default_value' => $config->get('custom.maxwidth'),
        '#size' => 30,
        '#description' => $this->t('Set a maximum width for loaded content. Example: "100%", 500, "500px".'),
        '#states' => $this->getState(static::STATE_CUSTOM_SETTINGS),
    ];
    $form['colorbox_custom_settings']['colorbox_maxheight'] = [
        '#type' => 'textfield',
        '#title' => $this->t('Max height'),
        '#default_value' => $config->get('custom.maxheight'),
        '#size' => 30,
        '#description' => $this->t('Set a maximum height for loaded content. Example: "100%", 500, "500px".'),
        '#states' => $this->getState(static::STATE_CUSTOM_SETTINGS),
    ];
    $form['colorbox_custom_settings']['colorbox_initialwidth'] = [
        '#type' => 'textfield',
        '#title' => $this->t('Initial width'),
        '#default_value' => $config->get('custom.initialwidth'),
        '#size' => 30,
        '#description' => $this->t('Set the initial width, prior to any content being loaded. Example: "100%", 500, "500px".'),
        '#states' => $this->getState(static::STATE_CUSTOM_SETTINGS),
    ];
    $form['colorbox_custom_settings']['colorbox_initialheight'] = [
        '#type' => 'textfield',
        '#title' => $this->t('Initial height'),
        '#default_value' => $config->get('custom.initialheight'),
        '#size' => 30,
        '#description' => $this->t('Set the initial height, prior to any content being loaded. Example: "100%", 500, "500px".'),
        '#states' => $this->getState(static::STATE_CUSTOM_SETTINGS),
    ];
    $form['colorbox_custom_settings']['colorbox_overlayclose'] = [
        '#type' => 'checkbox',
        '#title' => $this->t('Overlay close'),
        '#default_value' => $config->get('custom.overlayclose'),
        '#description' => $this->t('Enable closing Colorbox by clicking on the background overlay.'),
        '#states' => $this->getState(static::STATE_CUSTOM_SETTINGS),
    ];
    $form['colorbox_custom_settings']['colorbox_returnfocus'] = [
        '#type' => 'checkbox',
        '#title' => $this->t('Return focus'),
        '#default_value' => $config->get('custom.returnfocus'),
        '#description' => $this->t('Return focus when Colorbox exits to the element it was launched from.'),
        '#states' => $this->getState(static::STATE_CUSTOM_SETTINGS),
    ];
    $form['colorbox_custom_settings']['colorbox_fixed'] = [
        '#type' => 'checkbox',
        '#title' => $this->t('Fixed'),
        '#default_value' => $config->get('custom.fixed'),
        '#description' => $this->t("If the Colorbox should be displayed in a fixed position within the visitor's viewport or relative to the document."),
        '#states' => $this->getState(static::STATE_CUSTOM_SETTINGS),
    ];
    $form['colorbox_custom_settings']['colorbox_scrolling'] = [
        '#type' => 'checkbox',
        '#title' => $this->t('Scrollbars'),
        '#default_value' => $config->get('custom.scrolling'),
        '#description' => $this->t('If unchecked, Colorbox will hide scrollbars for overflowing content. This could be used on conjunction with the resize method for a smoother transition if you are appending content to an already open instance of Colorbox.'),
        '#states' => $this->getState(static::STATE_CUSTOM_SETTINGS),
    ];
    $form['colorbox_custom_settings']['colorbox_slideshow_settings'] = [
        '#type' => 'details',
        '#title' => $this->t('Slideshow settings'),
        '#collapsible' => TRUE,
        '#collapsed' => TRUE,
        '#states' => $this->getState(static::STATE_CUSTOM_SETTINGS),
    ];
    $form['colorbox_custom_settings']['colorbox_slideshow_settings']['colorbox_slideshow'] = [
        '#type' => 'radios',
        '#title' => $this->t('Slideshow'),
        '#options' => [
            0 => $this->t('Off'),
            1 => $this->t('On'),
        ],
        '#default_value' => $config->get('custom.slideshow.slideshow'),
        '#description' => $this->t('An automatic slideshow to a content group / gallery.'),
    ];
    $form['colorbox_custom_settings']['colorbox_slideshow_settings']['colorbox_slideshowauto'] = [
        '#type' => 'checkbox',
        '#title' => $this->t('Slideshow autostart'),
        '#default_value' => $config->get('custom.slideshow.auto'),
        '#description' => $this->t('If the slideshow should automatically start to play.'),
        '#states' => $this->getState(static::STATE_SLIDESHOW_ENABLED),
    ];
    $form['colorbox_custom_settings']['colorbox_slideshow_settings']['colorbox_slideshowspeed'] = [
        '#type' => 'select',
        '#title' => $this->t('Slideshow speed'),
        '#options' => $this->optionsRange(1000, 6000, 500),
        '#default_value' => $config->get('custom.slideshow.speed'),
        '#description' => $this->t('Sets the speed of the slideshow, in milliseconds.'),
        '#states' => $this->getState(static::STATE_SLIDESHOW_ENABLED),
    ];
    $form['colorbox_custom_settings']['colorbox_slideshow_settings']['colorbox_text_start'] = [
        '#type' => 'textfield',
        '#title' => $this->t('Start slideshow'),
        '#default_value' => $config->get('custom.slideshow.text_start'),
        '#size' => 30,
        '#description' => $this->t('Text for the slideshow start button.'),
        '#states' => $this->getState(static::STATE_SLIDESHOW_ENABLED),
    ];
    $form['colorbox_custom_settings']['colorbox_slideshow_settings']['colorbox_text_stop'] = [
        '#type' => 'textfield',
        '#title' => $this->t('Stop slideshow'),
        '#default_value' => $config->get('custom.slideshow.text_stop'),
        '#size' => 30,
        '#description' => $this->t('Text for the slideshow stop button.'),
        '#states' => $this->getState(static::STATE_SLIDESHOW_ENABLED),
    ];
    $form['colorbox_advanced_settings'] = [
        '#type' => 'details',
        '#title' => $this->t('Advanced settings'),
    ];
    $form['colorbox_advanced_settings']['colorbox_unique_token'] = [
        '#type' => 'radios',
        '#title' => $this->t('Unique per-request gallery token'),
        '#options' => [
            1 => $this->t('On'),
            0 => $this->t('Off'),
        ],
        '#default_value' => $config->get('advanced.unique_token'),
        '#description' => $this->t('If On (default), Colorbox will add a unique per-request token to the gallery id to avoid images being added manually to galleries. The token was added as a security fix but some see the old behavoiur as an feature and this settings makes it possible to remove the token.'),
    ];
    $form['colorbox_advanced_settings']['colorbox_mobile_detect'] = [
        '#type' => 'radios',
        '#title' => $this->t('Mobile detection'),
        '#options' => [
            1 => $this->t('On'),
            0 => $this->t('Off'),
        ],
        '#default_value' => $config->get('advanced.mobile_detect'),
        '#description' => $this->t('If on (default) Colorbox will not be active for devices with the max width set below.'),
    ];
    $form['colorbox_advanced_settings']['colorbox_mobile_device_width'] = [
        '#type' => 'textfield',
        '#title' => $this->t('Device width'),
        '#default_value' => $config->get('advanced.mobile_device_width'),
        '#size' => 30,
        '#description' => $this->t('Set the mobile device max width. Default: 480px.'),
        '#states' => [
            'visible' => [
                ':input[name="colorbox_mobile_detect"]' => [
                    'value' => '1',
                ],
            ],
        ],
    ];
    $form['colorbox_advanced_settings']['colorbox_caption_trim'] = [
        '#type' => 'radios',
        '#title' => $this->t('Caption shortening'),
        '#options' => [
            0 => $this->t('Default'),
            1 => $this->t('Yes'),
        ],
        '#default_value' => $config->get('advanced.caption_trim'),
        '#description' => $this->t('If the caption should be made shorter in the Colorbox to avoid layout problems. The default is to shorten for the example styles, they need it, but not for other styles.'),
    ];
    $form['colorbox_advanced_settings']['colorbox_caption_trim_length'] = [
        '#type' => 'select',
        '#title' => $this->t('Caption max length'),
        '#options' => $this->optionsRange(40, 120, 5),
        '#default_value' => $config->get('advanced.caption_trim_length'),
        '#states' => [
            'visible' => [
                ':input[name="colorbox_caption_trim"]' => [
                    'value' => '1',
                ],
            ],
        ],
    ];
    $form['colorbox_advanced_settings']['colorbox_compression_type'] = [
        '#type' => 'radios',
        '#title' => $this->t('Choose Colorbox compression level'),
        '#options' => [
            'minified' => $this->t('Production (Minified)'),
            'source' => $this->t('Development (Uncompressed Code)'),
        ],
        '#default_value' => $config->get('advanced.compression_type'),
    ];
    if (!$this->moduleHandler
        ->moduleExists('colorbox_load') || !$this->moduleHandler
        ->moduleExists('colorbox_inline')) {
        $form['colorbox_extras'] = [
            '#type' => 'details',
            '#title' => $this->t('Extras'),
        ];
        $form['colorbox_extras']['colorbox_additional_tips'] = [
            '#markup' => $this->t('You can find new features in the <a href="@url_colorbox_load" target="blank">Colorbox Load</a> and <a href="@url_colorbox_inline" target="blank">Colorbox Inline</a>', [
                '@url_colorbox_load' => 'https://www.drupal.org/project/colorbox_load',
                '@url_colorbox_inline' => 'https://www.drupal.org/project/colorbox_inline',
            ]),
        ];
    }
    return parent::buildForm($form, $form_state);
}