chore: add issue templates

2026-05-17 17:28:09 +00:00 · 2025-11-22 23:50:24 +02:00
parent d1f3c195dc
commit 87c4666fef
3 changed files with 291 additions and 0 deletions
--- a/ISSUE_TEMPLATE/bug_report.yml
+++ b/ISSUE_TEMPLATE/bug_report.yml
@@ -0,0 +1,212 @@
+name: Bug Report
+description: Report a bug or issue with the NextcloudAppTemplate app
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to report a bug! Please fill out the information below to help us investigate.
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Bug Description
+      description: A clear and concise description of what the bug is.
+      placeholder: Describe the bug...
+    validations:
+      required: true
+
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to Reproduce
+      description: Steps to reproduce the behavior
+      placeholder: |
+        1. Go to '...'
+        2. Click on '...'
+        3. Scroll down to '...'
+        4. See error
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected Behavior
+      description: What you expected to happen
+      placeholder: Describe what should happen...
+    validations:
+      required: true
+
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual Behavior
+      description: What actually happened
+      placeholder: Describe what actually happens...
+    validations:
+      required: true
+
+  - type: input
+    id: nextcloud-version
+    attributes:
+      label: Nextcloud Version
+      description: What version of Nextcloud are you running?
+      placeholder: e.g., 28.0.1
+    validations:
+      required: true
+
+  - type: input
+    id: app-version
+    attributes:
+      label: NextcloudAppTemplate App Version
+      description: What version of the NextcloudAppTemplate app are you using?
+      placeholder: e.g., 1.0.0
+    validations:
+      required: true
+
+  - type: input
+    id: php-version
+    attributes:
+      label: PHP Version
+      description: What version of PHP is your server running?
+      placeholder: e.g., 8.2.12
+    validations:
+      required: true
+
+  - type: dropdown
+    id: database
+    attributes:
+      label: Database
+      description: Which database are you using?
+      options:
+        - SQLite
+        - MySQL/MariaDB
+        - PostgreSQL
+        - Other
+    validations:
+      required: true
+
+  - type: input
+    id: browser
+    attributes:
+      label: Browser
+      description: Which browser are you using? (if applicable)
+      placeholder: e.g., Firefox 120, Chrome 119, Safari 17
+
+  - type: markdown
+    attributes:
+      value: |
+        ## 📋 Debugging Information
+
+        The following information helps us investigate and fix issues quickly. Please provide as much detail as possible.
+
+  - type: textarea
+    id: migration-status
+    attributes:
+      label: Migration Status
+      description: |
+        **How to check migration status:**
+
+        This shows which database migrations have been executed for the NextcloudAppTemplate app.
+
+        **For Docker installations:**
+        ```bash
+        docker exec --user www-data -i nextcloud-aio-nextcloud php occ migrations:status nextcloudapptemplate
+        ```
+
+        **For standard installations:**
+        ```bash
+        php occ migrations:status nextcloudapptemplate
+        ```
+
+        Or from the Nextcloud directory:
+        ```bash
+        sudo -u www-data php occ migrations:status nextcloudapptemplate
+        ```
+      placeholder: Paste the migration status output here...
+      render: shell
+
+  - type: textarea
+    id: nextcloud-logs
+    attributes:
+      label: Nextcloud Server Logs
+      description: |
+        **How to get server logs:**
+
+        Look for errors related to the NextcloudAppTemplate app (last 20-50 lines recommended).
+
+        **Via Web UI:**
+        - Go to Nextcloud Settings → Administration → Logging (or `/settings/admin/logging`)
+        - Look for entries containing "nextcloudapptemplate"
+
+        **For Docker installations:**
+        ```bash
+        docker exec --user www-data -i nextcloud-aio-nextcloud tail -100 /var/www/html/data/nextcloud.log | grep -i nextcloudapptemplate
+        ```
+
+        **For standard installations:**
+        ```bash
+        tail -100 /path/to/nextcloud/data/nextcloud.log | grep -i nextcloudapptemplate
+        ```
+
+        Or from the Nextcloud directory:
+        ```bash
+        sudo -u www-data tail -100 data/nextcloud.log | grep -i nextcloudapptemplate
+        ```
+      placeholder: Paste Nextcloud server logs here...
+      render: shell
+
+  - type: textarea
+    id: browser-console
+    attributes:
+      label: Browser Console Errors
+      description: |
+        **How to check browser console:**
+        1. Open the page where the issue occurs
+        2. Press **F12** (or right-click → Inspect → Console tab)
+        3. Look for red error messages
+        4. Copy any errors related to the NextcloudAppTemplate app
+
+        **Tip:** You can right-click on an error and select "Copy message" or "Copy stack trace"
+      placeholder: Paste browser console errors here...
+      render: javascript
+
+  - type: textarea
+    id: network-errors
+    attributes:
+      label: Network Request Errors
+      description: |
+        **How to check network requests:**
+        1. Open the page where the issue occurs
+        2. Press **F12** → Go to the **Network** tab
+        3. Reproduce the issue
+        4. Look for failed requests (shown in red or with 4xx/5xx status codes)
+        5. Click on the failed request
+        6. Copy the following information:
+           - **Request URL** (e.g., `/apps/nextcloudapptemplate/api/...`)
+           - **Status Code** (e.g., 500, 404, 403)
+           - **Response** tab content (the error message/data returned)
+
+        **Example format:**
+        ```
+        Request: POST /apps/nextcloudapptemplate/api/...
+        Status: 500 Internal Server Error
+        Response: {"error": "Database connection failed"}
+        ```
+      placeholder: Paste network error details here...
+      render: shell
+
+  - type: textarea
+    id: screenshots
+    attributes:
+      label: Screenshots
+      description: |
+        If applicable, add screenshots to help explain your problem.
+        You can drag and drop images directly into this field.
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional Context
+      description: Add any other context about the problem here (e.g., recent changes, specific configuration, workarounds attempted)
--- a/ISSUE_TEMPLATE/config.yml
+++ b/ISSUE_TEMPLATE/config.yml
@@ -0,0 +1,8 @@
+blank_issues_enabled: true
+contact_links:
+  - name: Nextcloud Community Forum
+    url: https://help.nextcloud.com
+    about: Ask questions and get help from the Nextcloud community
+  - name: Security Issue
+    url: https://github.com/chenasraf/nextcloud-nextcloudapptemplate/security/advisories/new
+    about: Report a security vulnerability privately
--- a/ISSUE_TEMPLATE/feature_request.yml
+++ b/ISSUE_TEMPLATE/feature_request.yml
@@ -0,0 +1,71 @@
+name: Feature Request
+description: Suggest a new feature or enhancement for the NextcloudAppTemplate app
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for suggesting a feature! Please provide as much detail as possible to help us understand your request.
+
+  - type: textarea
+    id: summary
+    attributes:
+      label: Feature Summary
+      description: A brief summary of the feature you'd like to see
+      placeholder: Summarize the feature in 1-2 sentences...
+    validations:
+      required: true
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem or Use Case
+      description: |
+        What problem does this feature solve? What's your use case?
+        Tip: "I'm always frustrated when..."
+      placeholder: Describe the problem or use case...
+    validations:
+      required: true
+
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed Solution
+      description: How would you like this feature to work?
+      placeholder: Describe your proposed solution...
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives Considered
+      description: Have you considered any alternative solutions or workarounds?
+      placeholder: Describe any alternative solutions or features you've considered...
+
+  - type: textarea
+    id: examples
+    attributes:
+      label: Examples
+      description: |
+        Are there any similar features in other apps that demonstrate what you're looking for?
+      placeholder: Provide links or descriptions of similar features elsewhere...
+
+  - type: dropdown
+    id: willing-to-contribute
+    attributes:
+      label: Willing to Contribute?
+      description: Would you be willing to contribute code for this feature?
+      options:
+        - "Yes, I can submit a PR"
+        - "Maybe, with guidance"
+        - "No, but I can help test"
+        - "No"
+    validations:
+      required: false
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional Context
+      description: Add any other context, mockups, or screenshots about the feature request here