GetUserGroupsTest.php in Organic groups 8

Namespace

Drupal\Tests\og\Kernel\Entity

File

tests/src/Kernel/Entity/GetUserGroupsTest.php

<?php

declare (strict_types=1);
namespace Drupal\Tests\og\Kernel\Entity;

use Drupal\KernelTests\KernelTestBase;
use Drupal\Tests\og\Traits\OgMembershipCreationTrait;
use Drupal\entity_test\Entity\EntityTest;
use Drupal\og\Entity\OgRole;
use Drupal\og\Og;
use Drupal\og\OgMembershipInterface;
use Drupal\og\OgRoleInterface;
use Drupal\user\Entity\User;

/**
 * Tests getting the memberships of an entity.
 *
 * @group og
 * @coversDefaultClass \Drupal\og\MembershipManager
 */
class GetUserGroupsTest extends KernelTestBase {
  use OgMembershipCreationTrait;

  /**
   * {@inheritdoc}
   */
  public static $modules = [
    'system',
    'user',
    'field',
    'og',
    'entity_test',
  ];

  /**
   * The OG membership manager.
   *
   * @var \Drupal\og\MembershipManagerInterface
   */
  protected $membershipManager;

  /**
   * A user object.
   *
   * @var \Drupal\user\Entity\User
   */
  protected $user1;

  /**
   * A user object.
   *
   * @var \Drupal\user\Entity\User
   */
  protected $user2;

  /**
   * A user object.
   *
   * @var \Drupal\user\Entity\User
   */
  protected $user3;

  /**
   * A group entity.
   *
   * @var \Drupal\entity_test\Entity\EntityTest
   */
  protected $group1;

  /**
   * A group entity.
   *
   * @var \Drupal\entity_test\Entity\EntityTest
   */
  protected $group2;

  /**
   * The machine name of the group node type.
   *
   * @var string
   */
  protected $groupBundle;

  /**
   * {@inheritdoc}
   */
  protected function setUp() : void {
    parent::setUp();
    $this
      ->installConfig([
      'og',
    ]);
    $this
      ->installEntitySchema('og_membership');
    $this
      ->installEntitySchema('user');
    $this
      ->installEntitySchema('entity_test');
    $this
      ->installSchema('system', 'sequences');
    $this->membershipManager = $this->container
      ->get('og.membership_manager');
    $this->groupBundle = mb_strtolower($this
      ->randomMachineName());

    // Create users.
    $this->user1 = User::create([
      'name' => $this
        ->randomString(),
    ]);
    $this->user1
      ->save();
    $this->user2 = User::create([
      'name' => $this
        ->randomString(),
    ]);
    $this->user2
      ->save();
    $this->user3 = User::create([
      'name' => $this
        ->randomString(),
    ]);
    $this->user3
      ->save();

    // Define the group content as group.
    Og::groupTypeManager()
      ->addGroup('entity_test', $this->groupBundle);

    // Create a group and associate with user 1.
    $this->group1 = EntityTest::create([
      'type' => $this->groupBundle,
      'name' => $this
        ->randomString(),
      'user_id' => $this->user1
        ->id(),
    ]);
    $this->group1
      ->save();

    // Create a group and associate with user 2.
    $this->group2 = EntityTest::create([
      'type' => $this->groupBundle,
      'name' => $this
        ->randomString(),
      'user_id' => $this->user2
        ->id(),
    ]);
    $this->group2
      ->save();
  }

  /**
   * Tests group owners have the correct groups.
   *
   * @todo Convert Og::isMember() calls to $this->membershipManager->isMember().
   */
  public function testOwnerGroupsOnly() {
    $actual = $this->membershipManager
      ->getUserGroups($this->user1
      ->id());
    $this
      ->assertCount(1, $actual['entity_test']);
    $this
      ->assertGroupExistsInResults($this->group1, $actual);

    // Also check isMember.
    $this
      ->assertTrue(Og::isMember($this->group1, $this->user1));
    $this
      ->assertFalse(Og::isMember($this->group1, $this->user2));
    $actual = $this->membershipManager
      ->getUserGroups($this->user2
      ->id());
    $this
      ->assertCount(1, $actual['entity_test']);
    $this
      ->assertGroupExistsInResults($this->group2, $actual);

    // Also check isMember.
    $this
      ->assertTrue(Og::isMember($this->group2, $this->user2));
    $this
      ->assertFalse(Og::isMember($this->group2, $this->user1));
  }

  /**
   * Tests other groups users are added to.
   *
   * @todo Convert Og::isMember() calls to $this->membershipManager->isMember().
   */
  public function testOtherGroups() {

    // Should not be a part of any groups.
    $this
      ->assertEquals([], $this->membershipManager
      ->getUserGroups($this->user3
      ->id()));
    $this
      ->assertFalse(Og::isMember($this->group1, $this->user3));
    $this
      ->assertFalse(Og::isMember($this->group2, $this->user3));

    // Invalidate the caches so the static cache is cleared and group data is
    // fetched again for the user.
    Og::invalidateCache();

    // Add user to group 1 should now return that group only.
    $this
      ->createOgMembership($this->group1, $this->user3);
    $actual = $this->membershipManager
      ->getUserGroups($this->user3
      ->id());
    $this
      ->assertCount(1, $actual['entity_test']);
    $this
      ->assertGroupExistsInResults($this->group1, $actual);
    $this
      ->assertTrue(Og::isMember($this->group1, $this->user3));
    $this
      ->assertFalse(Og::isMember($this->group2, $this->user3));
    Og::invalidateCache();

    // Add to group 2 should also return that.
    $this
      ->createOgMembership($this->group2, $this->user3);
    $actual = $this->membershipManager
      ->getUserGroups($this->user3
      ->id());
    $this
      ->assertCount(2, $actual['entity_test']);
    $this
      ->assertGroupExistsInResults($this->group1, $actual);
    $this
      ->assertGroupExistsInResults($this->group2, $actual);
    $this
      ->assertTrue(Og::isMember($this->group1, $this->user3));
    $this
      ->assertTrue(Og::isMember($this->group2, $this->user3));
  }

  /**
   * Tests member methods for states that other groups users are added to.
   *
   * @todo Convert Og::isMember() calls to $this->membershipManager->isMember().
   */
  public function testIsMemberStates() {

    // Add user to group 1 should now return that group only.
    $membership = $this
      ->createOgMembership($this->group1, $this->user3);

    // Default param is ACTIVE.
    $this
      ->assertTrue(Og::isMember($this->group1, $this->user3));
    $this
      ->assertFalse(Og::isMember($this->group1, $this->user3, [
      OgMembershipInterface::STATE_PENDING,
    ]));
    $this
      ->assertFalse(Og::isMember($this->group1, $this->user3, [
      OgMembershipInterface::STATE_BLOCKED,
    ]));
    $this
      ->assertFalse(Og::isMember($this->group1, $this->user3, [
      OgMembershipInterface::STATE_PENDING,
      OgMembershipInterface::STATE_BLOCKED,
    ]));
    $this
      ->assertFalse(Og::isMemberPending($this->group1, $this->user3));
    $this
      ->assertFalse(Og::isMemberBlocked($this->group1, $this->user3));

    // Change the membership state to PENDING.
    $membership
      ->setState(OgMembershipInterface::STATE_PENDING)
      ->save();
    Og::invalidateCache();
    $this
      ->assertTrue(Og::isMember($this->group1, $this->user3, [
      OgMembershipInterface::STATE_PENDING,
    ]));
    $this
      ->assertTrue(Og::isMemberPending($this->group1, $this->user3));
    $this
      ->assertTrue(Og::isMember($this->group1, $this->user3, [
      OgMembershipInterface::STATE_PENDING,
      OgMembershipInterface::STATE_BLOCKED,
    ]));
    $this
      ->assertFalse(Og::isMember($this->group1, $this->user3));
    $this
      ->assertFalse(Og::isMember($this->group1, $this->user3, [
      OgMembershipInterface::STATE_BLOCKED,
    ]));
    $this
      ->assertFalse(Og::isMemberBlocked($this->group1, $this->user3));

    // Change the membership state to BLOCKED.
    $membership
      ->setState(OgMembershipInterface::STATE_BLOCKED)
      ->save();
    Og::invalidateCache();
    $this
      ->assertTrue(Og::isMember($this->group1, $this->user3, [
      OgMembershipInterface::STATE_BLOCKED,
    ]));
    $this
      ->assertTrue(Og::isMemberBlocked($this->group1, $this->user3));
    $this
      ->assertTrue(Og::isMember($this->group1, $this->user3, [
      OgMembershipInterface::STATE_PENDING,
      OgMembershipInterface::STATE_BLOCKED,
    ]));
    $this
      ->assertFalse(Og::isMember($this->group1, $this->user3));
    $this
      ->assertFalse(Og::isMember($this->group1, $this->user3, [
      OgMembershipInterface::STATE_PENDING,
    ]));
    $this
      ->assertFalse(Og::isMemberPending($this->group1, $this->user3));
  }

  /**
   * Tests retrieval of groups filtered by roles.
   *
   * @covers ::getUserGroupIdsByRoleIds
   */
  public function testGetGroupsByRoles() {

    // Create a test role.
    $extra_role_1 = OgRole::create();
    $extra_role_1
      ->setName('extra_role_1')
      ->setLabel(mb_strtolower($this
      ->randomString()))
      ->setGroupType('entity_test')
      ->setGroupBundle($this->groupBundle)
      ->save();

    // Retrieve the default role for a member.
    $member_role = OgRole::getRole('entity_test', $this->groupBundle, OgRoleInterface::AUTHENTICATED);

    // Create memberships for the test user in the groups. The user will have
    // the normal member role in group 1 and both the normal member role and the
    // test role in group 2. In group 2 the user will have the blocked status so
    // we can test filtering by status.
    $this
      ->createOgMembership($this->group1, $this->user3);
    $this
      ->createOgMembership($this->group2, $this->user3, [
      $extra_role_1
        ->getName(),
    ], OgMembershipInterface::STATE_BLOCKED);

    // By default only active memberships are retrieved, so if we ask the
    // groups where the user is a normal member of the result should not include
    // group 2 where our test user is blocked.
    $groups = $this->membershipManager
      ->getUserGroupIdsByRoleIds($this->user3
      ->id(), [
      $member_role
        ->id(),
    ]);
    $this
      ->assertCount(1, $groups['entity_test']);
    $actual = reset($groups['entity_test']);
    $this
      ->assertEquals($this->group1
      ->id(), $actual);

    // When asking for the groups where our user has the test role, the result
    // should not include the blocked membership, so it should be empty.
    $groups = $this->membershipManager
      ->getUserGroupsByRoleIds($this->user3
      ->id(), [
      $extra_role_1
        ->id(),
    ]);
    $this
      ->assertCount(0, $groups);

    // Include all states.
    $groups = $this->membershipManager
      ->getUserGroupIdsByRoleIds($this->user3
      ->id(), [
      $member_role
        ->id(),
    ], OgMembershipInterface::ALL_STATES, FALSE);
    $this
      ->assertCount(2, $groups['entity_test']);

    // Request any of multiple roles.
    $groups = $this->membershipManager
      ->getUserGroupsByRoleIds($this->user3
      ->id(), [
      $member_role
        ->id(),
      $extra_role_1
        ->id(),
    ], OgMembershipInterface::ALL_STATES, FALSE);
    $this
      ->assertCount(2, $groups['entity_test']);

    // Request all of multiple roles.
    $groups = $this->membershipManager
      ->getUserGroupsByRoleIds($this->user3
      ->id(), [
      $member_role
        ->id(),
      $extra_role_1
        ->id(),
    ], OgMembershipInterface::ALL_STATES, TRUE);
    $this
      ->assertCount(1, $groups['entity_test']);
    $actual = reset($groups['entity_test']);
    $this
      ->assertEquals($this->group2
      ->id(), $actual
      ->id());
  }

  /**
   * Asserts whether a group ID exists in some results.
   *
   * Assumes entity_type is used.
   *
   * @param \Drupal\entity_test\Entity\EntityTest $group_to_check
   *   The group entity to check.
   * @param array $results
   *   Array keyed by the entity type, and with the group entities as values.
   */
  protected function assertGroupExistsInResults(EntityTest $group_to_check, array $results) {
    $found = FALSE;
    foreach ($results['entity_test'] as $group) {
      if ($group
        ->id() == $group_to_check
        ->id()) {
        $found = TRUE;
        break;
      }
    }
    $this
      ->assertTrue($found);
  }

}

Classes

Name	Description
GetUserGroupsTest	Tests getting the memberships of an entity.