allows editing post pubished dates. Auto updates post slug.

resources/views/admin/posts/create.php

@@ -16,8 +16,8 @@
 
 				<div class="mb-3">
 					<label for="slug" class="form-label">Slug</label>
-					<input type="text" class="form-control" id="slug" name="slug" required>
-					<small class="form-text text-muted">URL-friendly version of the title</small>
+					<input type="text" class="form-control" id="slug" name="slug" pattern="[a-z0-9-]+">
+					<small class="form-text text-muted">URL-friendly version. Leave blank to auto-generate from title.</small>
 				</div>
 
 				<div class="mb-3">
@@ -39,9 +39,16 @@
 					<select class="form-select" id="status" name="status" required>
 						<option value="draft">Draft</option>
 						<option value="published">Published</option>
+						<option value="scheduled">Scheduled</option>
 					</select>
 				</div>
 
+				<div class="mb-3" id="published-at-wrapper" style="display: none;">
+					<label for="published_at" class="form-label">Published Date/Time</label>
+					<input type="datetime-local" class="form-control" id="published_at" name="published_at">
+					<small class="form-text text-muted">Required for scheduled posts. Leave blank to use current date/time when publishing.</small>
+				</div>
+
 				<div class="mb-3">
 					<label for="featured_image" class="form-label">Featured Image</label>
 					<div class="input-group">
@@ -202,6 +209,15 @@ class: Embed,
 		document.getElementById('post-form').addEventListener('submit', async (e) => {
 			e.preventDefault();
 
+			// Validate scheduled posts have a published date
+			const status = document.getElementById('status').value;
+			const publishedAt = document.getElementById('published_at').value;
+
+			if (status === 'scheduled' && !publishedAt) {
+				alert('Scheduled posts require a published date/time.');
+				return;
+			}
+
 			try {
 				const savedData = await editor.save();
 				console.log('Saved data:', savedData);
@@ -218,6 +234,46 @@ class: Embed,
 	}
 }
 
+// Auto-generate slug from title
+document.getElementById('title').addEventListener('input', function() {
+	const slugInput = document.getElementById('slug');
+	if (!slugInput.value || slugInput.dataset.autoGenerated === 'true') {
+		const slug = this.value.toLowerCase()
+			.replace(/[^a-z0-9]+/g, '-')
+			.replace(/^-+|-+$/g, '');
+		slugInput.value = slug;
+		slugInput.dataset.autoGenerated = 'true';
+	}
+});
+
+// Mark slug as manually edited
+document.getElementById('slug').addEventListener('input', function() {
+	if (this.value) {
+		this.dataset.autoGenerated = 'false';
+	}
+});
+
+// Show/hide published date based on status
+function updatePublishedAtVisibility() {
+	const status = document.getElementById('status').value;
+	const publishedAtWrapper = document.getElementById('published-at-wrapper');
+	const publishedAtInput = document.getElementById('published_at');
+
+	if (status === 'published' || status === 'scheduled') {
+		publishedAtWrapper.style.display = 'block';
+		publishedAtInput.disabled = false;
+	} else {
+		publishedAtWrapper.style.display = 'none';
+		publishedAtInput.value = '';
+		publishedAtInput.disabled = true;
+	}
+}
+
+document.getElementById('status').addEventListener('change', updatePublishedAtVisibility);
+
+// Initialize on page load
+document.addEventListener('DOMContentLoaded', updatePublishedAtVisibility);
+
 // Featured image preview
 document.getElementById('featured_image').addEventListener('change', function() {
 	const preview = document.getElementById('featured_image_preview');

resources/views/admin/posts/edit.php

@@ -17,8 +17,8 @@
 
 				<div class="mb-3">
 					<label for="slug" class="form-label">Slug</label>
-					<input type="text" class="form-control" id="slug" name="slug" value="<?= htmlspecialchars( $post->getSlug() ) ?>" required>
-					<small class="form-text text-muted">URL-friendly version of the title</small>
+					<input type="text" class="form-control" id="slug" name="slug" value="<?= htmlspecialchars( $post->getSlug() ) ?>" pattern="[a-z0-9-]+">
+					<small class="form-text text-muted">URL-friendly version. Leave blank to auto-generate from title.</small>
 				</div>
 
 				<div class="mb-3">
@@ -40,9 +40,16 @@
 					<select class="form-select" id="status" name="status" required>
 						<option value="draft" <?= $post->getStatus() === 'draft' ? 'selected' : '' ?>>Draft</option>
 						<option value="published" <?= $post->getStatus() === 'published' ? 'selected' : '' ?>>Published</option>
+						<option value="scheduled" <?= $post->getStatus() === 'scheduled' ? 'selected' : '' ?>>Scheduled</option>
 					</select>
 				</div>
 
+				<div class="mb-3" id="published-at-wrapper" style="display: <?= in_array($post->getStatus(), ['published', 'scheduled']) ? 'block' : 'none' ?>;">
+					<label for="published_at" class="form-label">Published Date/Time</label>
+					<input type="datetime-local" class="form-control" id="published_at" name="published_at" value="<?= $post->getPublishedAt() ? $post->getPublishedAt()->format('Y-m-d\TH:i') : '' ?>">
+					<small class="form-text text-muted">Required for scheduled posts. Leave blank to use current date/time when publishing.</small>
+				</div>
+
 				<div class="mb-3">
 					<label for="featured_image" class="form-label">Featured Image</label>
 					<div class="input-group">
@@ -228,6 +235,15 @@ class: Embed,
 		document.getElementById('post-form').addEventListener('submit', async (e) => {
 			e.preventDefault();
 
+			// Validate scheduled posts have a published date
+			const status = document.getElementById('status').value;
+			const publishedAt = document.getElementById('published_at').value;
+
+			if (status === 'scheduled' && !publishedAt) {
+				alert('Scheduled posts require a published date/time.');
+				return;
+			}
+
 			try {
 				const savedData = await editor.save();
 				console.log('Saved data:', savedData);
@@ -244,6 +260,46 @@ class: Embed,
 	}
 }
 
+// Auto-generate slug from title
+document.getElementById('title').addEventListener('input', function() {
+	const slugInput = document.getElementById('slug');
+	if (!slugInput.value || slugInput.dataset.autoGenerated === 'true') {
+		const slug = this.value.toLowerCase()
+			.replace(/[^a-z0-9]+/g, '-')
+			.replace(/^-+|-+$/g, '');
+		slugInput.value = slug;
+		slugInput.dataset.autoGenerated = 'true';
+	}
+});
+
+// Mark slug as manually edited
+document.getElementById('slug').addEventListener('input', function() {
+	if (this.value) {
+		this.dataset.autoGenerated = 'false';
+	}
+});
+
+// Show/hide published date based on status
+function updatePublishedAtVisibility() {
+	const status = document.getElementById('status').value;
+	const publishedAtWrapper = document.getElementById('published-at-wrapper');
+	const publishedAtInput = document.getElementById('published_at');
+
+	if (status === 'published' || status === 'scheduled') {
+		publishedAtWrapper.style.display = 'block';
+		publishedAtInput.disabled = false;
+	} else {
+		publishedAtWrapper.style.display = 'none';
+		// Don't clear the value - preserve existing published dates from database
+		publishedAtInput.disabled = true;
+	}
+}
+
+document.getElementById('status').addEventListener('change', updatePublishedAtVisibility);
+
+// Initialize on page load
+document.addEventListener('DOMContentLoaded', updatePublishedAtVisibility);
+
 // Featured image preview
 document.getElementById('featured_image').addEventListener('change', function() {
 	const preview = document.getElementById('featured_image_preview');

src/Cms/Dtos/posts/create-post-request.yaml

@@ -39,3 +39,8 @@ dto:
     type: string
     required: true
     enum: ['draft', 'published', 'scheduled']
+
+  published_at:
+    type: string
+    required: false
+    pattern: '/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}$|^$/'  # datetime-local format: YYYY-MM-DDTHH:MM or empty

src/Cms/Dtos/posts/update-post-request.yaml

@@ -39,3 +39,8 @@ dto:
     type: string
     required: true
     enum: ['draft', 'published', 'scheduled']
+
+  published_at:
+    type: string
+    required: false
+    pattern: '/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}$|^$/'  # datetime-local format: YYYY-MM-DDTHH:MM or empty

src/Cms/Services/Post/Creator.php

@@ -56,6 +56,7 @@ public function create( Dto $request, array $categoryIds = [], string $tagNames
 		$slug = $request->slug ?? null;
 		$excerpt = $request->excerpt ?? null;
 		$featuredImage = $request->featured_image ?? null;
+		$publishedAt = $request->published_at ?? null;
 
 		$post = new Post();
 		$post->setTitle( $title );
@@ -67,9 +68,24 @@ public function create( Dto $request, array $categoryIds = [], string $tagNames
 		$post->setStatus( $status );
 		$post->setCreatedAt( new DateTimeImmutable() );
 
-		// Business rule: auto-set published date for published posts
-		if( $status === ContentStatus::PUBLISHED->value )
+		// Business rule: set published date
+		if( $status === ContentStatus::SCHEDULED->value )
 		{
+			// Scheduled posts MUST have a published date
+			if( !$publishedAt || trim( $publishedAt ) === '' )
+			{
+				throw new \InvalidArgumentException( 'Scheduled posts require a published date' );
+			}
+			$post->setPublishedAt( $this->parseDateTime( $publishedAt ) );
+		}
+		elseif( $publishedAt && trim( $publishedAt ) !== '' )
+		{
+			// Use provided published date
+			$post->setPublishedAt( $this->parseDateTime( $publishedAt ) );
+		}
+		elseif( $status === ContentStatus::PUBLISHED->value )
+		{
+			// Auto-set to now for published posts when not provided
 			$post->setPublishedAt( new DateTimeImmutable() );
 		}
 
@@ -97,4 +113,27 @@ private function generateSlug( string $title ): string
 	{
 		return $this->_slugGenerator->generate( $title, 'post' );
 	}
+
+	/**
+	 * Safely parse a datetime string into DateTimeImmutable
+	 *
+	 * @param string $dateTimeString The datetime string to parse
+	 * @return DateTimeImmutable
+	 * @throws \InvalidArgumentException If the datetime string is invalid
+	 */
+	private function parseDateTime( string $dateTimeString ): DateTimeImmutable
+	{
+		try
+		{
+			return new DateTimeImmutable( $dateTimeString );
+		}
+		catch( \DateMalformedStringException | \Exception $e )
+		{
+			throw new \InvalidArgumentException(
+				"Invalid published date format: '{$dateTimeString}'. Please provide a valid datetime.",
+				0,
+				$e
+			);
+		}
+	}
 }

src/Cms/Services/Post/Updater.php

@@ -56,6 +56,7 @@ public function update( Dto $request, array $categoryIds = [], string $tagNames
 		$slug = $request->slug ?? null;
 		$excerpt = $request->excerpt ?? null;
 		$featuredImage = $request->featured_image ?? null;
+		$publishedAt = $request->published_at ?? null;
 
 		// Look up the post
 		$post = $this->_postRepository->findById( $id );
@@ -71,9 +72,24 @@ public function update( Dto $request, array $categoryIds = [], string $tagNames
 		$post->setFeaturedImage( $featuredImage );
 		$post->setStatus( $status );
 
-		// Business rule: auto-set published date when changing to published status
-		if( $status === ContentStatus::PUBLISHED->value && !$post->getPublishedAt() )
+		// Business rule: set published date
+		if( $status === ContentStatus::SCHEDULED->value )
 		{
+			// Scheduled posts MUST have a published date
+			if( !$publishedAt || trim( $publishedAt ) === '' )
+			{
+				throw new \InvalidArgumentException( 'Scheduled posts require a published date' );
+			}
+			$post->setPublishedAt( $this->parseDateTime( $publishedAt ) );
+		}
+		elseif( $publishedAt && trim( $publishedAt ) !== '' )
+		{
+			// Use provided published date
+			$post->setPublishedAt( $this->parseDateTime( $publishedAt ) );
+		}
+		elseif( $status === ContentStatus::PUBLISHED->value && !$post->getPublishedAt() )
+		{
+			// Auto-set to now for published posts when not provided and not already set
 			$post->setPublishedAt( new \DateTimeImmutable() );
 		}
 
@@ -102,4 +118,27 @@ private function generateSlug( string $title ): string
 	{
 		return $this->_slugGenerator->generate( $title, 'post' );
 	}
+
+	/**
+	 * Safely parse a datetime string into DateTimeImmutable
+	 *
+	 * @param string $dateTimeString The datetime string to parse
+	 * @return \DateTimeImmutable
+	 * @throws \InvalidArgumentException If the datetime string is invalid
+	 */
+	private function parseDateTime( string $dateTimeString ): \DateTimeImmutable
+	{
+		try
+		{
+			return new \DateTimeImmutable( $dateTimeString );
+		}
+		catch( \DateMalformedStringException | \Exception $e )
+		{
+			throw new \InvalidArgumentException(
+				"Invalid published date format: '{$dateTimeString}'. Please provide a valid datetime.",
+				0,
+				$e
+			);
+		}
+	}
 }