README.md

Table of content

• Description
• Installation
  • Install with Composer
  • Add service provider to App
  • Add facade alias to App
  • Publish vendor with Artisan
  • Tables details
  • Make migration with Artisan
• Usage
  • Groups
    • Create, Delete, Update, Users list, Add member, Join request, Accept join, Decline join, Join request list
  • Posts
    • Create, Get, Update, Delete, Add to group, Group posts list, User posts list
  • Comments
    • Add, Get, Update, Delete
  • Reporting
    • Report, Remove, Toggle , Count
  • Likes
    • Like, Unlike, Toggle, Count

Description

This package allows you to add user groups (groups, comment, like ...) system to your Laravel 5 application.

Installation

1. Via Composer, from the command line, run :

composer require musonza/groups

2. Add the service provider to ./config/app.php in providers array, like :

    /*
     * Package Service Providers...
     */
    Musonza\Groups\GroupsServiceProvider::class,

3. You can use the facade for shorter code. Add this to ./config/app.php at the end of aliases array :

    'Groups' => Musonza\Groups\Facades\GroupsFacade::class,

Note : The class is bound to the ioC as Groups.

$groups = App::make('Groups');

4. From the command line, publish the assets:

php artisan vendor:publish

Note : This will publish database migrations in ./database/migrations/.

create_groups_table // main groups table
    id
    name
    description
    short_description
    image
    url
    user_id
    private
    conversation_id
    extra_info
    settings

# Usage

## Groups 

1. ##### Create a group

```php
$group = Groups::create($userId, $data);

Note : Accepted fields in $data array :

$data = [
  'name'              => '',
  'description'       => '', // optional
  'short_description' => '', // optional
  'image'             => '', // optional
  'private'           => 0,  // 0 (public) or 1 (private)
  'extra_info'        => '', // optional
  'settings'          => '', // optional
  'conversation_id'   => 0,  // optional if you want to add messaging to your groups this can be useful
];

2. Delete a group

$group->delete();

3. Update a group

$group->update($updateArray);

4. Get user instance with group relations

$user = Groups::getUser($userId); 

5. Add members to group

$group->addMembers([$userId, $userId2, ...]);

6. Request to join a group

$group->request($userId);

7. Accept a group request

$group->acceptRequest($userId);

8. Decline a group request

$group->declineRequest($userId);

9. Group requests

$requests = $group->requests;

10. How many groups a user is member of

$user = Groups::getUser($userId); 
$count = $user->groups->count();

11. Remove member(s) from group

$group->leave([$userId, $userId2, ...]);

Posts

1. Create a post

$post = Groups::createPost($data);

Note : Acceptable values for Post $data array

$data = [
  'title'      => '', 
  'user_id'    => 0, 
  'body'       => '', 
  'type'       => '', 
  'extra_info' => '',
];

2. Get post

$post = Groups::post($postId);

3. Update a post

$post->update($data);

4. Delete a post

$post->delete();

5. Add a post to a group

$group->attachPost($postId);

6. Add multiple posts to a group

$group->attachPost([$postId, $postId2, ...]);

7. Remove post from a group

$group->detachPost($postId);

8. Group posts

$posts = $group->posts;

$posts = $group->posts()->paginate(5);

$posts = $group->posts()->orderBy('id', 'DESC')->paginate(5);

9. User posts

$user = Groups::getUser($userId);

$posts = $user->posts;

Comments

Note : Acceptable values for Comment $data array

$data = [
  'post_id' => 0,  
  'user_id' => 0, 
  'body'    => '',
];

1. Add comment

$comment = Groups::addComment($data);

2. Get comment

$comment = Groups::comment($commentId);

3. Update a comment

$comment->update($data);

4. Delete a comment

$comment->delete();

Reporting

1. Report a comment or post

$comment->report($userIdOfReporter);
$post->report($userIdOfReporter);

2. Remove a post or comment report

$post->removeReport($userId);
$comment->removeReport($userId);

3. Toggle report/unreport a post or comment

$post->toggleReport($userId);
$comment->toggleReport($userId);

4. Post or Comment Report count

$commentReports = $comment->reportsCount;
$postReports = $post->reportsCount;

Likes

1. Like a post or comment

$post->like($userId);
$comment->like($userId);

2. Unlike a post or comment

$post->unlike($userId);
$comment->unlike($userId);

3. Toggle like/unlike a post or comment

$post->toggleLike($userId);
$comment->toggleLike($userId);

4. Post or Comment likes count

$postLikes = $post->likesCount;
$commentLikes = $comment->likesCount;