You are here

Home » API reference » Social Post 8.2

README.txt in Social Post 8.2

Same filename and directory in other branches
  1. 3.x README.txt
CONTENTS OF THIS FILE
---------------------

 * Introduction
 * Requirements
 * Installation
 * Configuration
 * Maintainers


INTRODUCTION
------------

Social Post is part of the Social API. It provides a common interface for
creating modules related to autoposting to external provider services.

This module defines a path Administration » Configuration » Social API » Social
Post which displays a table of implementers (modules to autopost to external
providers on users' behalf).

This module does not restrict the way an implementer provides its functionality.
This allows the implementers to adapt to the external provider's requirements
they implement.

 * For a full description of the module, visit the project page:
  https://www.drupal.org/project/social_post

 * To submit bug reports and feature suggestions, or to track changes:
  https://www.drupal.org/project/issues/social_post


REQUIREMENTS
------------

This module requires the following module and library:

 * Required module: Social API (https://www.drupal.org/project/social_api)
 * Required library: The League OAuth2 client library


INSTALLATION
------------

 * To download the module with all dependencies run the below command:
  composer require drupal/social_post:^2.0

 * Install the module from admin module page (Administration » Extend) or using
  the drush command:
  drush en social_post


CONFIGURATION
-------------

 * Configure user permissions in Administration » People » Permissions:
  - Delete Social Post user accounts

    Users in roles with the "Delete Social Post user accounts" permission can
    delete all user accounts associated to all Drupal users.

  - Delete own Social Post user accounts

    Users in roles with the "Delete own Social Post user accounts" permission
    can delete own Social Post user accounts.

  - View Social Post user entity lists

    Users in roles with the "View Social Post user entity lists" permission can
    view Social Post user entity lists.

 * Go to Configuration » Social API settings » Autoposting settings.
  The list looks empty initially as you have not enabled an implementer yet.

 * To post to external providers, you need to install their respective Social
  Post implementers. After installing implementers, they will be displayed in
  the Social Post implementer list.

  Visit https://www.drupal.org/project/social_post to find all the available
  Social Post implementers.


MAINTAINERS
-----------

Current maintainers:
 * Getulio Valentin Sánchez (gvso) - https://www.drupal.org/u/gvso

This project has been supported by:
 * Google Summer of Code
  An annual program for university students organized by Google with projects
  managed by open source organization mentors such as us (Drupal!).
  Visit g.co/gsoc for more information.

 * Google Code-In
  The Google Code-In is a contest to introduce pre-university students (ages
  13-17) to the many kinds of contributions that make open source software
  development possible. Visit g.co/gci for more information.

File

README.txt
View source 
  1. 

  2. CONTENTS OF THIS FILE

  3. ---------------------

  4. 

  5.  * Introduction

  6.  * Requirements

  7.  * Installation

  8.  * Configuration

  9.  * Maintainers

  10. 

  11. 

  12. INTRODUCTION

  13. ------------

  14. 

  15. Social Post is part of the Social API. It provides a common interface for

  16. creating modules related to autoposting to external provider services.

  17. 

  18. This module defines a path Administration » Configuration » Social API » Social

  19. Post which displays a table of implementers (modules to autopost to external

  20. providers on users' behalf).

  21. 

  22. This module does not restrict the way an implementer provides its functionality.

  23. This allows the implementers to adapt to the external provider's requirements

  24. they implement.

  25. 

  26.  * For a full description of the module, visit the project page:

  27.   https://www.drupal.org/project/social_post

  28. 

  29.  * To submit bug reports and feature suggestions, or to track changes:

  30.   https://www.drupal.org/project/issues/social_post

  31. 

  32. 

  33. REQUIREMENTS

  34. ------------

  35. 

  36. This module requires the following module and library:

  37. 

  38.  * Required module: Social API (https://www.drupal.org/project/social_api)

  39.  * Required library: The League OAuth2 client library

  40. 

  41. 

  42. INSTALLATION

  43. ------------

  44. 

  45.  * To download the module with all dependencies run the below command:

  46.   composer require drupal/social_post:^2.0

  47. 

  48.  * Install the module from admin module page (Administration » Extend) or using

  49.   the drush command:

  50.   drush en social_post

  51. 

  52. 

  53. CONFIGURATION

  54. -------------

  55. 

  56.  * Configure user permissions in Administration » People » Permissions:

  57.   - Delete Social Post user accounts

  58. 

  59.     Users in roles with the "Delete Social Post user accounts" permission can

  60.     delete all user accounts associated to all Drupal users.

  61. 

  62.   - Delete own Social Post user accounts

  63. 

  64.     Users in roles with the "Delete own Social Post user accounts" permission

  65.     can delete own Social Post user accounts.

  66. 

  67.   - View Social Post user entity lists

  68. 

  69.     Users in roles with the "View Social Post user entity lists" permission can

  70.     view Social Post user entity lists.

  71. 

  72.  * Go to Configuration » Social API settings » Autoposting settings.

  73.   The list looks empty initially as you have not enabled an implementer yet.

  74. 

  75.  * To post to external providers, you need to install their respective Social

  76.   Post implementers. After installing implementers, they will be displayed in

  77.   the Social Post implementer list.

  78. 

  79.   Visit https://www.drupal.org/project/social_post to find all the available

  80.   Social Post implementers.

  81. 

  82. 

  83. MAINTAINERS

  84. -----------

  85. 

  86. Current maintainers:

  87.  * Getulio Valentin Sánchez (gvso) - https://www.drupal.org/u/gvso

  88. 

  89. This project has been supported by:

  90.  * Google Summer of Code

  91.   An annual program for university students organized by Google with projects

  92.   managed by open source organization mentors such as us (Drupal!).

  93.   Visit g.co/gsoc for more information.

  94. 

  95.  * Google Code-In

  96.   The Google Code-In is a contest to introduce pre-university students (ages

  97.   13-17) to the many kinds of contributions that make open source software

  98.   development possible. Visit g.co/gci for more information.