# Decap CMS Setup for ARC Website

## Overview

This website uses Decap CMS (formerly Netlify CMS) for content management. It allows authorized users to create, edit, and manage blog posts through a web interface.

## Current Setup Status

**Error**: "Unable to access identity settings. When using git-gateway backend make sure to enable Identity service and Git Gateway."

This means Netlify Identity and Git Gateway need to be properly configured.

## Setup Instructions

### 1. Enable Netlify Identity

1. Go to your Netlify dashboard: https://app.netlify.com/
2. Select your site (ym1ktc.netlify.app)
3. Navigate to **Site settings** → **Identity**
4. Click **"Enable Identity"**
5. In Identity settings, configure:
   - **Registration**: Set to "Invite only" (recommended for security)
   - **External providers**: Optionally enable GitHub, Google, etc.
   - **Field validation**: No changes needed for basic setup

### 2. Configure Git Gateway

**This is the crucial step that's currently missing:**

1. In your site's Identity settings
2. Go to **"Services"** tab
3. Click **"Enable Git Gateway"**
4. This allows Decap CMS to commit directly to your GitHub repository
5. **Important**: Git Gateway requires the Identity service to be enabled first

### 3. Configure Custom Domain Access

Since you're using https://taslak.radio.org.tr/, ensure:

1. The custom domain is properly configured in Netlify
2. Identity service works on both domains:
   - https://ym1ktc.netlify.app/admin/
   - https://taslak.radio.org.tr/admin/

### 4. Invite Users

After Identity and Git Gateway are enabled:

1. In Identity tab, click **"Invite users"**
2. Enter email addresses of content editors
3. They will receive invitation emails
4. Users must accept invitations to access the CMS

### 5. Access the CMS

- Primary URL: `https://taslak.radio.org.tr/admin/`
- Backup URL: `https://ym1ktc.netlify.app/admin/`
- Users can log in with their invited credentials
- The CMS will redirect to `/decapcms/` for the actual interface

## Features

### Turkish Interface

- All field labels are in Turkish
- Configured for Turkish content creators
- Default author set to "TA1SPH"

### Blog Post Management

- Create new blog posts
- Edit existing posts
- Upload featured images
- Organize with categories and tags
- Markdown editor for content

### File Structure

- Blog posts are stored in `src/data/post/`
- Images are stored in `src/assets/images/`
- Posts use the format: `YYYY-MM-DD-slug.md`

## Configuration Files

### `/public/decapcms/config.yml`

Main configuration file that defines:

- Backend (Git Gateway)
- Collections (Blog posts)
- Fields and their types
- Media handling

### `/public/decapcms/index.html`

The CMS interface HTML file

### `/public/_redirects`

Netlify redirect rules for admin routing

## Usage

1. Users navigate to `/admin/`
2. They are redirected to the CMS interface
3. After authentication, they can:
   - Create new blog posts
   - Edit existing posts
   - Upload images
   - Manage categories and tags

## Security

- Only invited users can access the CMS
- All changes are committed to the main repository
- GitHub Actions will automatically deploy changes
- Content is version-controlled through Git

## Troubleshooting

### Fixed Issues:

✅ **"Unable to access identity settings"** - This was fixed by enabling Identity and Git Gateway in Netlify
✅ **Confirmation email links not working** - Created `/auth` page to handle authentication tokens

### Current Setup Status:

The site now has:
- Custom authentication handler at `/auth`
- Proper redirect handling for confirmation emails
- Automatic routing from hash-based tokens to query parameters

**If you're still getting confirmation email issues:**
1. Go to https://app.netlify.com/sites/ym1ktc/settings/identity
2. Check that Identity is enabled
3. Go to Services tab and ensure "Git Gateway" is enabled
4. The confirmation links should now work properly

### Common Issues:

1. **"Unable to access identity settings"**: Enable Identity service and Git Gateway in Netlify dashboard
2. **Can't log in**: Check if Identity is enabled and user is invited
3. **Can't save posts**: Ensure Git Gateway is enabled and connected to GitHub
4. **Images not uploading**: Check media folder permissions in repository
5. **Custom domain issues**: Ensure Identity works on both netlify.app and custom domain
6. **404 on /admin/**: Check that _redirects file is deployed correctly

### Quick Verification Steps:

1. Check Identity status: https://app.netlify.com/sites/ym1ktc/settings/identity
2. Check Git Gateway: Should show "Connected" status when properly configured
3. Test admin access: https://taslak.radio.org.tr/admin/
4. Check browser console for JavaScript errors

### Support

For technical issues, contact the development team or check the Decap CMS documentation at https://decapcms.org/docs/

**Netlify-specific help:** https://docs.netlify.com/visitor-access/identity/