nextcloud / nextcloud/academy

Write admin settings (IAppConfig vs IConfig) for php-i-11

Open
#25 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
TypeScript
Stars
2
Forks
1
Avg merge
1d 2h
Merged PRs (30d)
7

Description

Write the admin settings content for php-i-11 (Settings and Admin Panel). The manifest declares it; the content does not exist.

The specific gap

The beginner track covers user-level permissions and auth, but does not distinguish:

  • IConfig — per-user settings
  • IAppConfig — admin-level, app-wide settings

That distinction is the substance of this module, along with ISettings for registering an admin panel.

Deliberately deferred from beginner on 2026-06-11 as part of the "you know how the app works, now here is how to do it the Nextcloud way" cluster.

Source material

Tutorial 5 (Smart Picker) in course/files/tutorials/ covers admin settings via IAppConfig and is useful as a cross-check.

Scope

Content for php-i-11 and its ExApp mirror.

Part of #16.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reading Tutorial 5 (Smart Picker) in course/files/tutorials/ and then inspect the existing php-i-11 content and its ExApp mirror. Cover the distinction between IConfig and IAppConfig, explain ISettings for registering an admin panel, and ensure both content locations are complete.

Written by the indexing model from the issue text.

Assessment

Tech stack
php
Domain
documentation
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
72/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.