README.txt in Twitter Profile Widget 8

CONTENTS OF THIS FILE
---------------------
 * Introduction
 * Requirements
 * Installation
 * Configuration
 * Theming
 * Developers
 * Maintainers

INTRODUCTION
------------
This module provides GET integration with the Twitter API. After registering API credentials, create any number of widgets, each of which will display tweets from any account or timeline. Per-widget configuration includes whether to display replies & retweets and how many tweets should display.

By design, the default "theming" is minimal. Developers are expected to customize the display via their chosen theme.


INSTALLATION
------------
1. Install as you would normally install a contributed drupal module. See:
  https://www.drupal.org/documentation/install/modules-themes/modules-8
  for further information.

2. Go to 'Manage > Extend', and enable the Twitter Profile Widget module (drush en twitter_profile_widget).

CONFIGURATION
-------------
1. You first need a Twitter App. This is different from the Twitter widget ID, and allows you to connect to the Twitter API. To get a Twitter App, sign in to Twitter and go to https://apps.twitter.com/ . Copy the "key" and "secret" associated with your new app.

2. After installing the module in Drupal, go to Configuration > Media > Twitter Widgets (admin/config/media/twitter_profile_widget). Enter the Twitter App key and secret you created in step #1.

3. Go to Content > Twitter widgets (admin/content/twitter_widget) and create one or more widgets. The "description" is internal, to identify different widgets.

4. Now that you have Twitter widgets set up, you can display them in any part of your site via either entity reference or block display (each time you create a widget, it creates a corresponding block at /admin/structure/block/block-content).

For example, you could use the built-in Structure > Block Layout > Place Block interface to put the widget on one or more pages. Alternatively, you could use Context [2] or Panels [3] to place the twitter widget block. Or you could create an entity reference field on a node and embed the widget that way.

[2] https://www.drupal.org/project/context
[3] https://www.drupal.org/project/panels

THEMING
-------
By design, the display of tweets  provided by this module is minimal. Developers can copy the twitter_widget.html.twig file from the /templates directory and add it to their theme and customize as necessary.

To negate the CSS provided by this module, remove the {{ attach_library('twitter_profile_widget/twitter-profile-widget') }} from the twig file, or point it to your own defined library.

DEVELOPERS
----------
The Twitter Profile Widget provides ways for developers to extend or customize the framework. All available hooks are listed in twitter_profile_widget.api.php.

PHP 7 has different requirements for cURL requests over HTTPS. If you are use
PHP 7 and get the error "Uncaught PHP Exception Exception: "SSL certificate problem: unable to get local issuer certificate," you will need to resolve this
in your PHP setup.

MAINTAINERS
-----------
Current maintainers:
 * Mark Fullmer (mark_fullmer) - https://www.drupal.org/u/mark_fullmer