paperless-ngx/src-ui/src/app/components/admin/settings/settings.component.html

<pngx-page-header
  title="Settings"
  i18n-title
  info="Options to customize appearance, notifications, saved views and more. Settings apply to the <strong>current user only</strong>."
  i18n-info
  >
  <button class="btn btn-sm btn-outline-primary" (click)="tourService.start()"><ng-container i18n>Start tour</ng-container></button>
  <a *pngxIfPermissions="{ action: PermissionAction.View, type: PermissionType.Admin }" class="btn btn-sm btn-primary ms-3" href="admin/" target="_blank">
    <ng-container i18n>Open Django Admin</ng-container>
    <i-bs name="arrow-up-right"></i-bs>
  </a>
</pngx-page-header>

<form [formGroup]="settingsForm" (ngSubmit)="saveSettings()">

  <ul ngbNav #nav="ngbNav" (navChange)="onNavChange($event)" [(activeId)]="activeNavID" class="nav-tabs">
    <li [ngbNavItem]="SettingsNavIDs.General">
      <a ngbNavLink i18n>General</a>
      <ng-template ngbNavContent>

        <h4 i18n>Appearance</h4>

        <div class="row mb-3">
          <div class="col-md-3 col-form-label pt-0">
            <span i18n>Display language</span>
          </div>
          <div class="col">

            <select class="form-select" formControlName="displayLanguage">
              @for (lang of displayLanguageOptions; track lang) {
                <option [ngValue]="lang.code">{{lang.name}}@if (lang.code && currentLocale !== 'en-US') {
                  <span> - {{lang.englishName}}</span>
                }</option>
              }
            </select>

            @if (displayLanguageIsDirty) {
              <small class="form-text text-primary" i18n>You need to reload the page after applying a new language.</small>
            }

          </div>
        </div>

        <div class="row mb-3">
          <div class="col-md-3 col-form-label pt-0">
            <span i18n>Date display</span>
          </div>
          <div class="col">

            <select class="form-select" formControlName="dateLocale">
              @for (lang of dateLocaleOptions; track lang) {
                <option [ngValue]="lang.code">{{lang.name}}@if (lang.code) {
                  <span> - {{today | customDate:'shortDate':null:lang.code}}</span>
                }</option>
              }
            </select>

          </div>
        </div>

        <div class="row mb-3">
          <div class="col-md-3 col-form-label pt-0">
            <span i18n>Date format</span>
          </div>
          <div class="col">

            <div class="form-check">
              <input type="radio" id="dateFormatShort" name="dateFormat" class="form-check-input" formControlName="dateFormat" value="shortDate">
              <label class="form-check-label" for="dateFormatShort" i18n>Short: {{today | customDate:'shortDate':null:computedDateLocale}}</label>
            </div>
            <div class="form-check">
              <input type="radio" id="dateFormatMedium" name="dateFormat" class="form-check-input" formControlName="dateFormat" value="mediumDate">
              <label class="form-check-label" for="dateFormatMedium" i18n>Medium: {{today | customDate:'mediumDate':null:computedDateLocale}}</label>
            </div>
            <div class="form-check">
              <input type="radio" id="dateFormatLong" name="dateFormat" class="form-check-input" formControlName="dateFormat" value="longDate">
              <label class="form-check-label" for="dateFormatLong" i18n>Long: {{today | customDate:'longDate':null:computedDateLocale}}</label>
            </div>

          </div>
        </div>

        <div class="row mb-3">
          <div class="col-md-3 col-form-label pt-0">
            <span i18n>Items per page</span>
          </div>
          <div class="col">

            <select class="form-select" formControlName="documentListItemPerPage">
              <option [ngValue]="10">10</option>
              <option [ngValue]="25">25</option>
              <option [ngValue]="50">50</option>
              <option [ngValue]="100">100</option>
            </select>

          </div>
        </div>

        <div class="row mb-3">
          <div class="col-md-3 col-form-label pt-0">
            <span i18n>Document editor</span>
          </div>
          <div class="col">

            <pngx-input-check i18n-title title="Use PDF viewer provided by the browser" i18n-hint hint="This is usually faster for displaying large PDF documents, but it might not work on some browsers." formControlName="useNativePdfViewer"></pngx-input-check>

          </div>
        </div>

        <div class="row mb-3">
          <div class="col-md-3 col-form-label pt-0">
            <span i18n>Sidebar</span>
          </div>
          <div class="col">

            <pngx-input-check i18n-title title="Use 'slim' sidebar (icons only)" formControlName="slimSidebarEnabled"></pngx-input-check>

          </div>
        </div>

        <div class="row mb-3">
          <div class="col-md-3 col-form-label pt-0">
            <span i18n>Dark mode</span>
          </div>
          <div class="col">
            <pngx-input-check i18n-title title="Use system settings" formControlName="darkModeUseSystem"></pngx-input-check>
            <pngx-input-check [hidden]="settingsForm.value.darkModeUseSystem" i18n-title title="Enable dark mode" formControlName="darkModeEnabled"></pngx-input-check>
            <pngx-input-check i18n-title title="Invert thumbnails in dark mode" formControlName="darkModeInvertThumbs"></pngx-input-check>
          </div>
        </div>

        <div class="row mb-3">
          <div class="col-md-3 col-form-label pt-0">
            <span i18n>Theme Color</span>
          </div>
          <div class="col col-md-3">
            <pngx-input-color i18n-title formControlName="themeColor" [error]="error?.color"></pngx-input-color>
          </div>
          <div class="col-2">
            <button class="btn btn-link btn-sm pt-2 ps-0" [disabled]="!this.settingsForm.get('themeColor').value" (click)="clearThemeColor()">
              <i-bs width="1em" height="1em" name="x"></i-bs><ng-container i18n>Reset</ng-container>
            </button>
          </div>
        </div>

        <h4 class="mt-4" id="update-checking" i18n>Update checking</h4>

        <div class="row mb-3">
          <div class="offset-md-3 col">
            <p i18n>
            Update checking works by pinging the public <a href="https://api.github.com/repos/paperless-ngx/paperless-ngx/releases/latest" target="_blank" rel="noopener noreferrer">GitHub API</a> for the latest release to determine whether a new version is available.<br/>
            Actual updating of the app must still be performed manually.
          </p>
            <p i18n>
            <em>No tracking data is collected by the app in any way.</em>
          </p>
            <pngx-input-check i18n-title title="Enable update checking" formControlName="updateCheckingEnabled"></pngx-input-check>
          </div>
        </div>

        <h4 class="mt-4" i18n>Document editing</h4>

        <div class="row mb-3">
          <div class="offset-md-3 col">
            <pngx-input-check i18n-title title="Automatically remove inbox tag(s) on save" formControlName="documentEditingRemoveInboxTags"></pngx-input-check>
          </div>
        </div>

        <h4 class="mt-4" i18n>Bulk editing</h4>

        <div class="row mb-3">
          <div class="offset-md-3 col">
            <pngx-input-check i18n-title title="Show confirmation dialogs" formControlName="bulkEditConfirmationDialogs" i18n-hint hint="Deleting documents will always ask for confirmation."></pngx-input-check>
            <pngx-input-check i18n-title title="Apply on close" formControlName="bulkEditApplyOnClose"></pngx-input-check>
          </div>
        </div>

        <h4 class="mt-4" i18n>Notes</h4>

        <div class="row mb-3">
          <div class="offset-md-3 col">
            <pngx-input-check i18n-title title="Enable notes" formControlName="notesEnabled"></pngx-input-check>
          </div>
        </div>

      </ng-template>
    </li>

    <li [ngbNavItem]="SettingsNavIDs.Permissions">
      <a ngbNavLink i18n>Permissions</a>
      <ng-template ngbNavContent>

        <h4 i18n>Default Permissions</h4>

        <div class="row mb-3">
          <div class="offset-md-3 col">
            <p i18n>
            Settings apply to this user account for objects (Tags, Mail Rules, etc.) created via the web UI
          </p>
          </div>
        </div>
        <div class="row mb-3">
          <div class="col-md-3 col-form-label pt-0">
            <span i18n>Default Owner</span>
          </div>
          <div class="col-md-5">
            <pngx-input-select [items]="users" bindLabel="username" formControlName="defaultPermsOwner" [allowNull]="true"></pngx-input-select>
            <small class="form-text text-muted text-end d-block mt-n2" i18n>Objects without an owner can be viewed and edited by all users</small>
          </div>
        </div>
        <div class="row mb-3">
          <div class="col-md-3 col-form-label pt-0">
            <span i18n>Default View Permissions</span>
          </div>
          <div class="col-md-5">
            <div class="row">
              <div class="col-3">
                <span class="d-block pt-1" i18n>Users:</span>
              </div>
              <div class="col">
                <ng-container *pngxIfPermissions="{ action: PermissionAction.View, type: PermissionType.User }">
                  <pngx-permissions-user type="view" formControlName="defaultPermsViewUsers"></pngx-permissions-user>
                </ng-container>
              </div>
            </div>
            <div class="row">
              <div class="col-3">
                <span class="d-block pt-1" i18n>Groups:</span>
              </div>
              <div class="col">
                <ng-container *pngxIfPermissions="{ action: PermissionAction.View, type: PermissionType.Group }">
                  <pngx-permissions-group type="view" formControlName="defaultPermsViewGroups"></pngx-permissions-group>
                </ng-container>
              </div>
            </div>
          </div>
        </div>
        <div class="row mb-3">
          <div class="col-md-3 col-form-label pt-0">
            <span i18n>Default Edit Permissions</span>
          </div>
          <div class="col-md-5">
            <div class="row">
              <div class="col-3">
                <span class="d-block pt-1" i18n>Users:</span>
              </div>
              <div class="col">
                <ng-container *pngxIfPermissions="{ action: PermissionAction.View, type: PermissionType.User }">
                  <pngx-permissions-user type="view" formControlName="defaultPermsEditUsers"></pngx-permissions-user>
                </ng-container>
              </div>
            </div>
            <div class="row">
              <div class="col-3">
                <span class="d-block pt-1" i18n>Groups:</span>
              </div>
              <div class="col">
                <ng-container *pngxIfPermissions="{ action: PermissionAction.View, type: PermissionType.Group }">
                  <pngx-permissions-group type="view" formControlName="defaultPermsEditGroups"></pngx-permissions-group>
                </ng-container>
              </div>
            </div>
            <div class="row">
              <small class="form-text text-muted text-end d-block" i18n>Edit permissions also grant viewing permissions</small>
            </div>
          </div>
        </div>
      </ng-template>
    </li>

    <li [ngbNavItem]="SettingsNavIDs.Notifications">
      <a ngbNavLink i18n>Notifications</a>
      <ng-template ngbNavContent>

        <h4 i18n>Document processing</h4>

        <div class="row mb-3">
          <div class="offset-md-3 col">
            <pngx-input-check i18n-title title="Show notifications when new documents are detected" formControlName="notificationsConsumerNewDocument"></pngx-input-check>
            <pngx-input-check i18n-title title="Show notifications when document processing completes successfully" formControlName="notificationsConsumerSuccess"></pngx-input-check>
            <pngx-input-check i18n-title title="Show notifications when document processing fails" formControlName="notificationsConsumerFailed"></pngx-input-check>
            <pngx-input-check i18n-title title="Suppress notifications on dashboard" formControlName="notificationsConsumerSuppressOnDashboard" i18n-hint hint="This will suppress all messages about document processing status on the dashboard."></pngx-input-check>
          </div>
        </div>

      </ng-template>
    </li>

    <li [ngbNavItem]="SettingsNavIDs.SavedViews">
      <a ngbNavLink i18n>Saved views</a>
      <ng-template ngbNavContent>

        <h4 i18n>Settings</h4>
        <div class="row mb-3">
          <div class="offset-md-3 col">
            <pngx-input-check i18n-title title="Show warning when closing saved views with unsaved changes" formControlName="savedViewsWarnOnUnsavedChange"></pngx-input-check>
          </div>
        </div>

        <h4 i18n>Views</h4>
        <div formGroupName="savedViews">

          @for (view of savedViews; track view) {
            <div [formGroupName]="view.id" class="row">
              <div class="mb-3 col">
                <label class="form-label" for="name_{{view.id}}" i18n>Name</label>
                <input type="text" class="form-control" formControlName="name" id="name_{{view.id}}">
              </div>
              <div class="mb-2 col">
                <label class="form-label" for="show_on_dashboard_{{view.id}}" i18n>&nbsp;<span class="visually-hidden">Appears on</span></label>
                <div class="form-check form-switch">
                  <input type="checkbox" class="form-check-input" id="show_on_dashboard_{{view.id}}" formControlName="show_on_dashboard">
                  <label class="form-check-label" for="show_on_dashboard_{{view.id}}" i18n>Show on dashboard</label>
                </div>
                <div class="form-check form-switch">
                  <input type="checkbox" class="form-check-input" id="show_in_sidebar_{{view.id}}" formControlName="show_in_sidebar">
                  <label class="form-check-label" for="show_in_sidebar_{{view.id}}" i18n>Show in sidebar</label>
                </div>
              </div>
              <div class="mb-2 col-auto">
                <label class="form-label" for="name_{{view.id}}" i18n>Actions</label>

                <pngx-confirm-button
                  label="Delete"
                  i18n-label
                  (confirm)="deleteSavedView(view)"
                  *pngxIfPermissions="{ action: PermissionAction.Delete, type: PermissionType.SavedView }"
                  buttonClasses="btn-sm btn-outline-danger form-control"
                  iconName="trash">
                </pngx-confirm-button>
              </div>
            </div>
          }

          @if (savedViews && savedViews.length === 0) {
            <div i18n>No saved views defined.</div>
          }

          @if (!savedViews) {
            <div>
              <div class="spinner-border spinner-border-sm fw-normal ms-2 me-auto" role="status"></div>
              <div class="visually-hidden" i18n>Loading...</div>
            </div>
          }

        </div>

      </ng-template>
    </li>
  </ul>

  <div [ngbNavOutlet]="nav" class="border-start border-end border-bottom p-3 mb-3 shadow-sm"></div>

  <button type="submit" class="btn btn-primary mb-2" *pngxIfPermissions="{ action: PermissionAction.Change, type: PermissionType.UISettings }" [disabled]="(isDirty$ | async) === false" i18n>Save</button>
</form>