fix(teams): allow hiding the shared folder button via config.php

Organizations that want Team Folders instead of personal shares can hide
the team-page action that creates a personal folder and shares it with
the team.

Fixes #5638

Assisted-by: Cursor Grok:cursor-grok-4.6
Signed-off-by: Lennart Joswig <mail@ljoswig.de>
Co-authored-by: Cursor <cursoragent@cursor.com>

Author: lennart441

README.md

@@ -33,6 +33,27 @@ The app is distributed through the [app store](https://apps.nextcloud.com/apps/c
 
 Release tarballs are hosted at https://github.com/nextcloud-releases/contacts/releases.
 
+## Configuration
+
+The following options can be set in Nextcloud's `config/config.php`:
+
+```php
+/**
+ * Hide the button on the team page that creates a personal folder and
+ * shares it with the team. Useful when organizations want users to use
+ * Team Folders instead of personal shares for collaborative work.
+ *
+ * Defaults to false (the button is shown).
+ */
+'contacts.hide_team_shared_folder_creation' => true,
+```
+
+Or via occ:
+
+```bash
+occ config:system:set contacts.hide_team_shared_folder_creation --type=boolean --value=true
+```
+
 ## :satellite: Support
 
 If you need assistance or want to ask a question about Contacts, you are welcome to [ask for support](https://help.nextcloud.com) in our forums. If you have found a bug, feel free to open a new Issue on GitHub. Keep in mind, that this repository only manages the frontend. If you find bugs or have problems with the CardDAV-Backend, you should ask the team at [Nextcloud server](https://github.com/nextcloud/server) for help!

lib/AppInfo/Application.php

@@ -22,6 +22,12 @@
 class Application extends App implements IBootstrap {
 	public const APP_ID = 'contacts';
 
+	/**
+	 * System config key (config.php) to hide the "create a personal folder
+	 * and share it with the team" button on the team page.
+	 */
+	public const CONFIG_HIDE_TEAM_SHARED_FOLDER_CREATION = 'contacts.hide_team_shared_folder_creation';
+
 	public function __construct() {
 		parent::__construct(self::APP_ID);
 	}

lib/Controller/PageController.php

@@ -66,6 +66,8 @@ public function index(): TemplateResponse {
 
 		$isTalkVersionCompatible = $this->compareVersion->isCompatible($talkVersion ? $talkVersion : '0.0.0', 2);
 
+		$hideTeamSharedFolderCreation = $this->config->getSystemValueBool(Application::CONFIG_HIDE_TEAM_SHARED_FOLDER_CREATION, false);
+
 		$this->initialState->provideInitialState('isGroupSharingEnabled', $isGroupSharingEnabled);
 		$this->initialState->provideInitialState('locales', $locales);
 		$this->initialState->provideInitialState('defaultProfile', $defaultProfile);
@@ -75,6 +77,7 @@ public function index(): TemplateResponse {
 		$this->initialState->provideInitialState('isContactsInteractionEnabled', $isContactsInteractionEnabled);
 		$this->initialState->provideInitialState('isCirclesEnabled', $isCirclesEnabled && $isCircleVersionCompatible);
 		$this->initialState->provideInitialState('isTalkEnabled', $isTalkEnabled && $isTalkVersionCompatible);
+		$this->initialState->provideInitialState('hideTeamSharedFolderCreation', $hideTeamSharedFolderCreation);
 
 		Util::addStyle(Application::APP_ID, 'contacts-main');
 		Util::addScript(Application::APP_ID, 'contacts-main');

src/components/CircleDetails.vue

@@ -151,7 +151,7 @@
 					</div>
 
 					<!-- Team resource creation shortcuts -->
-					<div v-if="circle.isMember" class="resource-shortcuts">
+					<div v-if="circle.isMember && resourceTypes.length > 0" class="resource-shortcuts">
 						<h3 class="resource-shortcuts__title">
 							{{ t('contacts', 'Create') }}
 						</h3>
@@ -327,6 +327,7 @@ import TeamResourceButton from './CircleDetails/TeamResourceButton.vue'
 import MemberList from './MemberList/MemberList.vue'
 import CircleActionsMixin from '../mixins/CircleActionsMixin.js'
 import { CircleEdit, editCircle } from '../services/circles.ts'
+import hideTeamSharedFolderCreation from '../services/hideTeamSharedFolderCreation.js'
 
 import 'cropperjs/dist/cropper.css'
 
@@ -540,7 +541,7 @@ export default {
 					helperText: t('contacts', 'This will create a regular folder shared with the team. To create a Team Folder, please contact your {productName} administrator', { productName: OC.theme.name }),
 					icon: 'FolderOutlineIcon',
 					apiPath: 'files',
-					enabled: enabledApps.files !== undefined,
+					enabled: enabledApps.files !== undefined && !hideTeamSharedFolderCreation,
 				},
 				{
 					id: 'talk',

src/services/hideTeamSharedFolderCreation.js

@@ -0,0 +1,9 @@
+/**
+ * SPDX-FileCopyrightText: 2026 Nextcloud GmbH and Nextcloud contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+import { loadState } from '@nextcloud/initial-state'
+
+const hideTeamSharedFolderCreation = loadState('contacts', 'hideTeamSharedFolderCreation', false)
+export default hideTeamSharedFolderCreation

tests/unit/Controller/PageControllerTest.php

@@ -88,4 +88,25 @@ public function testIndex() {
 		$this->assertEquals('user', $result->getRenderAs());
 		$this->assertTrue($result instanceof TemplateResponse);
 	}
+
+	public function testIndexProvidesHideTeamSharedFolderCreation() {
+		$user = $this->createMock(IUser::class);
+		$user->method('getUid')->willReturn('mrstest');
+		$this->userSession->method('getUser')->willReturn($user);
+
+		$this->config->expects($this->once())
+			->method('getSystemValueBool')
+			->with('contacts.hide_team_shared_folder_creation', false)
+			->willReturn(true);
+
+		$states = [];
+		$this->initialStateService->method('provideInitialState')
+			->willReturnCallback(function (string $key, mixed $value) use (&$states): void {
+				$states[$key] = $value;
+			});
+
+		$this->controller->index();
+
+		$this->assertTrue($states['hideTeamSharedFolderCreation']);
+	}
 }