namespace BlogEngine.Core

{

using System;

using System.Collections;

using System.Collections.Generic;

using System.ComponentModel;

using System.Globalization;

using System.Linq;

using System.Net.Mail;

using System.Text;

using System.Text.RegularExpressions;

using System.Web;

using BlogEngine.Core.Data.Models;

using BlogEngine.Core.Providers;

/// <summary>

/// A post is an entry on the blog - a blog post.

/// </summary>

[Serializable]

public class Post : BusinessBase<Post, Guid>, IComparable<Post>, IPublishable

{

#region Constants and Fields

/// <summary>

/// The sync root.

/// </summary>

private static readonly object SyncRoot = new object();

/// <summary>

/// The categories.

/// </summary>

private readonly StateList<Category> categories;

/// <summary>

/// All comments, including deleted

/// </summary>

private readonly List<Comment> allcomments;

/// <summary>

/// The notification emails.

/// </summary>

private readonly StateList<string> notificationEmails;

/// <summary>

/// The post tags.

/// </summary>

private readonly StateList<string> tags;

/// <summary>

/// The posts.

/// </summary>

private static Dictionary<Guid, List<Post>> posts = new Dictionary<Guid, List<Post>>();

/// <summary>

/// The deleted posts.

/// </summary>

private static Dictionary<Guid, List<Post>> deletedposts = new Dictionary<Guid, List<Post>>();

/// <summary>

/// The author.

/// </summary>

private string author;

/// <summary>

/// The content.

/// </summary>

private string content;

/// <summary>

/// The description - UNIFIED METADATA: This serves as the primary meta description.

/// Part of the unified SEO/GEO metadata model. Used for meta description tags,

/// Open Graph og:description, Twitter Card description, and Schema.org description.

/// </summary>

/// <remarks>

/// BACKWARD COMPATIBILITY: Legacy property maintained for existing code.

/// In the unified model, this is the authoritative source for all description metadata.

/// SemanticSummary provides an alternative AI-optimized description when set.

/// </remarks>

private string description;

/// <summary>

/// Whether the post is comments enabled.

/// </summary>

private bool hasCommentsEnabled;

/// <summary>

/// The nested comments.

/// </summary>

private List<Comment> nestedComments;

/// <summary>

/// Whether the post is published.

/// </summary>

private bool isPublished;

/// <summary>

/// Whether the post is deleted.

/// </summary>

private bool isDeleted;

/// <summary>

/// The raters.

/// </summary>

private int raters;

/// <summary>

/// The rating.

/// </summary>

private float rating;

/// <summary>

/// The slug of the post.

/// </summary>

private string slug;

/// <summary>

/// The title.

/// </summary>

private string title;

#region Unified SEO/GEO Metadata Fields

/// <summary>

/// UNIFIED METADATA: Canonical URL for the post.

/// </summary>

/// <remarks>

/// Part of the unified SEO/GEO metadata model.

/// - SEO: Prevents duplicate content penalties, establishes primary URL identity

/// - GEO: Helps AI systems identify the authoritative source for this content

/// Used in: canonical link tag, og:url, Schema.org url property

/// </remarks>

private string canonicalUrl;

/// <summary>

/// UNIFIED METADATA: Schema.org type (e.g., "BlogPosting", "Article", "NewsArticle").

/// </summary>

/// <remarks>

/// Part of the unified SEO/GEO metadata model.

/// - SEO: Helps search engines understand content type for rich snippets

/// - GEO: Critical for AI systems to properly classify and understand content

/// Defaults to "BlogPosting" if not specified.

/// </remarks>

private string schemaType;

/// <summary>

/// UNIFIED METADATA: Comma-separated key entities mentioned in the post.

/// </summary>

/// <remarks>

/// Part of the unified SEO/GEO metadata model (primarily GEO-focused).

/// - GEO: Named entities (people, organizations, locations, concepts) for AI extraction

/// - SEO: Can enhance semantic understanding in advanced search systems

/// Example: "Machine Learning, Neural Networks, TensorFlow"

/// Used in: Custom metadata tags, Schema.org mentions/about properties

/// </remarks>

private string keyEntities;

/// <summary>

/// UNIFIED METADATA: Semantic summary optimized for AI systems.

/// </summary>

/// <remarks>

/// Part of the unified SEO/GEO metadata model (primarily GEO-focused).

/// - GEO: Concise, semantically rich summary emphasizing key concepts and relationships

/// - SEO: Alternative to traditional description for AI-powered search

/// Unlike Description, this focuses on semantic meaning and entity relationships.

/// Falls back to Description if not set. Used in: AI-specific meta tags, structured data

/// </remarks>

private string semanticSummary;

/// <summary>

/// UNIFIED METADATA: Main Subject Line (MSL) for content classification.

/// </summary>

/// <remarks>

/// Part of the unified SEO/GEO metadata model (primarily GEO-focused).

/// - GEO: Primary subject/topic for AI topic modeling and categorization

/// - SEO: Can be used for content clustering and site organization

/// Should be a single, clear phrase (e.g., "Cloud Computing Best Practices")

/// Used in: Custom classification tags, Schema.org about property

/// </remarks>

private string contentMSL;

/// <summary>

/// UNIFIED METADATA: Meta keywords for search engines and AI systems.

/// </summary>

/// <remarks>

/// Part of the unified SEO/GEO metadata model.

/// - SEO: Traditional keyword meta tag (lower weight in modern search)

/// - GEO: Still valuable for AI systems and specialized search

/// CONSOLIDATED: This field unifies all keyword storage. Legacy 'keywords' usage

/// should map to this field for backward compatibility.

/// Used in: meta keywords tag, Schema.org keywords property

/// </remarks>

private string metaKeywords;

/// <summary>

/// UNIFIED METADATA: Meta robots directives (e.g., "index, follow", "noindex").

/// </summary>

/// <remarks>

/// Part of the unified SEO/GEO metadata model.

/// - SEO: Controls search engine crawling and indexing behavior

/// - GEO: Can include/exclude content from AI training data and generative results

/// Common values: "index, follow", "noindex, follow", "index, nofollow", "noindex, nofollow"

/// Extended for GEO: "noai", "noimageai" directives may be added

/// Used in: meta robots tag, HTTP headers, robots.txt references

/// </remarks>

private string metaRobots;

/// <summary>

/// UNIFIED METADATA: Open Graph data (JSON serialized).

/// </summary>

/// <remarks>

/// Part of the unified SEO/GEO metadata model.

/// - SEO: Rich social media previews on Facebook, LinkedIn, etc.

/// - GEO: Provides structured context for AI systems analyzing social shares

/// USAGE PATTERN: This field is for CUSTOM OVERRIDES only.

/// By default, SeoMetadataManager generates OG tags from other metadata properties.

/// Store JSON here only when you need to override the default OG tag generation.

/// Example: {"og:video": "https://...", "og:video:type": "video/mp4"}

/// </remarks>

private string openGraphData;

/// <summary>

/// UNIFIED METADATA: Breadcrumb label for navigation structure.

/// </summary>

/// <remarks>

/// Part of the unified SEO/GEO metadata model.

/// - SEO: Used in Schema.org BreadcrumbList for rich snippets

/// - GEO: Helps AI understand page hierarchy and site structure

/// Falls back to post title if not set.

/// Used in: Schema.org BreadcrumbList structured data

/// </remarks>

private string breadcrumbLabel;

/// <summary>

/// UNIFIED METADATA: Schema.org organization name for this post.

/// </summary>

/// <remarks>

/// Part of the unified SEO/GEO metadata model.

/// - SEO: Organization attribution in structured data for rich snippets

/// - GEO: Helps AI systems understand organizational context and authority

/// Can override blog-level organization for posts from guest authors or partners.

/// Used in: Schema.org publisher/organization properties

/// </remarks>

private string schemaOrganization;

#endregion

#endregion

#region Constructors and Destructors

/// <summary>

/// Initializes a new instance of the <see cref = "Post" /> class.

/// The default contstructor assign default values.

/// </summary>

public Post()

{

this.Id = Guid.NewGuid();

this.allcomments = new List<Comment>();

this.categories = new StateList<Category>();

this.tags = new StateList<string>();

this.notificationEmails = new StateList<string>();

this.DateCreated = new DateTime();

this.isPublished = true;

this.hasCommentsEnabled = true;

}

static Post()

{

Blog.Saved += (s, e) =>

{

if (e.Action == SaveAction.Delete)

{

Blog blog = s as Blog;

if (blog != null)

{

RefreshPostLists(blog);

}

}

};

}

#endregion

#region Events

/// <summary>

/// Occurs before a new comment is added.

/// </summary>

public static event EventHandler<CancelEventArgs> AddingComment;

/// <summary>

/// Occurs when a comment is added.

/// </summary>

public static event EventHandler<EventArgs> CommentAdded;

/// <summary>

/// Occurs when a comment has been removed.

/// </summary>

public static event EventHandler<EventArgs> CommentRemoved;

/// <summary>

/// Occurs when a comment has been purged.

/// </summary>

public static event EventHandler<EventArgs> CommentPurged;

/// <summary>

/// Occurs when a comment has been restored.

/// </summary>

public static event EventHandler<EventArgs> CommentRestored;

/// <summary>

/// Occurs when a comment is updated.

/// </summary>

public static event EventHandler<EventArgs> CommentUpdated;

/// <summary>

/// Occurs when a visitor rates the post.

/// </summary>

public static event EventHandler<EventArgs> Rated;

/// <summary>

/// Occurs before comment is removed.

/// </summary>

public static event EventHandler<CancelEventArgs> RemovingComment;

/// <summary>

/// Occurs before comment is purged.

/// </summary>

public static event EventHandler<CancelEventArgs> PurgingComment;

/// <summary>

/// Occurs before comment is restored.

/// </summary>

public static event EventHandler<CancelEventArgs> RestoringComment;

/// <summary>

/// Occurs when the post is being served to the output stream.

/// </summary>

public static event EventHandler<ServingEventArgs> Serving;

/// <summary>

/// Occurs when the post is being published.

/// </summary>

public static event EventHandler<CancelEventArgs> Publishing;

/// <summary>

/// Occurs when a post is published.

/// </summary>

public static event EventHandler<EventArgs> Published;

/// <summary>

/// Occurs before a new comment is updated.

/// </summary>

public static event EventHandler<CancelEventArgs> UpdatingComment;

#endregion

#region Post Properties

/// <summary>

/// Gets a sorted collection of all undeleted posts in the blog.

/// Sorted by date.

/// </summary>

public static List<Post> Posts

{

get

{

Blog blog = Blog.CurrentInstance;

List<Post> blogPosts;

if (!posts.TryGetValue(blog.BlogId, out blogPosts))

{

lock (SyncRoot)

{

if (!posts.TryGetValue(blog.BlogId, out blogPosts))

{

posts[blog.Id] = blogPosts = BlogService.FillPosts().Where(p => p.IsDeleted == false).ToList();

blogPosts.TrimExcess();

AddRelations(blogPosts);

}

}

}

return blogPosts;

}

}

/// <summary>

/// Gets a sorted collection of all undeleted posts across all blogs.

/// Sorted by date.

/// </summary>

public static List<Post> AllBlogPosts

{

get

{

List<Blog> blogs = Blog.Blogs.Where(b => b.IsActive).ToList();

Guid originalBlogInstanceIdOverride = Blog.InstanceIdOverride;

List<Post> postsAcrossAllBlogs = new List<Post>();

// Posts are not loaded for a blog instance until that blog

// instance is first accessed. For blog instances where the

// posts have not yet been loaded, using InstanceIdOverride to

// temporarily switch the blog CurrentInstance blog so the Posts

// for that blog instance can be loaded.

//

for (int i = 0; i < blogs.Count; i++)

{

List<Post> blogPosts;

if (!posts.TryGetValue(blogs[i].Id, out blogPosts))

{

// temporarily override the Current BlogId to the

// blog Id we need posts to be loaded for.

Blog.InstanceIdOverride = blogs[i].Id;

blogPosts = Posts;

Blog.InstanceIdOverride = originalBlogInstanceIdOverride;

}

postsAcrossAllBlogs.AddRange(blogPosts);

}

postsAcrossAllBlogs.Sort();

// do not call AddRelations(). that will change the Next/Previous properties

// to point to posts in other blogs, which leads to the Next / Previous

// posts pointing to posts in other blog instances when viewing a single post

// (in post.aspx). If Next/Previous is needed for the posts returned

// here in AllBlogPosts, would be better to create new properties

// (e.g. AllBlogsNextPost, AllBlogsPreviousPost).

// AddRelations(postsAcrossAllBlogs);

return postsAcrossAllBlogs;

}

}

/// <summary>

/// Gets a sorted collection of all undeleted posts, taking into account the

/// current blog instance's Site Aggregation status in determining if posts

/// from just the current instance or all instances should be returned.

/// Sorted by date.

/// </summary>

/// <remarks>

/// This logic could be put into the normal 'Posts' property, however

/// there are times when a Site Aggregation blog instance may just need

/// its own posts. So ApplicablePosts can be called when data across

/// all blog instances may be needed, and Posts can be called when data

/// for just the current blog instance is needed.

/// </remarks>

public static List<Post> ApplicablePosts

{

get

{

if (Blog.CurrentInstance.IsSiteAggregation)

return AllBlogPosts;

else

return Posts;

}

}

/// <summary>

/// Gets a sorted collection of all deleted posts in the blog.

/// Sorted by date.

/// </summary>

public static List<Post> DeletedPosts

{

get

{

Blog blog = Blog.CurrentInstance;

List<Post> blogPosts;

if (!deletedposts.TryGetValue(blog.Id, out blogPosts))

{

lock (SyncRoot)

{

if (!deletedposts.TryGetValue(blog.Id, out blogPosts))

{

blogPosts = BlogService.FillPosts().Where(p => p.IsDeleted == true).ToList();

deletedposts[blog.Id] = blogPosts;

}

}

}

return blogPosts;

}

}

/// <summary>

/// Gets or sets the Author or the post.

/// </summary>

public string Author

{

get

{

return this.author;

}

set

{

base.SetValue("Author", value, ref this.author);

}

}

/// <summary>

/// Gets AuthorProfile.

/// </summary>

public AuthorProfile AuthorProfile

{

get

{

return AuthorProfile.GetProfile(this.Author);

}

}

/// <summary>

/// Gets an unsorted List of categories.

/// </summary>

public StateList<Category> Categories

{

get

{

return this.categories;

}

}

/// <summary>

/// Gets or sets the Content or the post.

/// </summary>

public string Content

{

get

{

return this.content;

}

set

{

base.SetValue("Content", value, ref this.content);

// This is commented out only because I can't find any reference to

// this cache item anywhere in the project. So it seems pretty obscure

// if it's supposed to be used by plugins or something else.

//if (base.SetValue("Content", value, ref this.content))

//{

// Blog.CurrentInstance.Cache.Remove("content_" + this.Id);

//}

}

}

/// <summary>

/// Gets or sets the Description of the post.

/// </summary>

/// <remarks>

/// UNIFIED METADATA: This is the primary meta description in the unified SEO/GEO model.

/// - SEO: Used in meta description tags for search engine results

/// - GEO: Provides context for AI summarization and content understanding

/// BACKWARD COMPATIBILITY: Legacy property maintained. This is the authoritative source

/// for all description metadata unless SemanticSummary provides an AI-optimized alternative.

/// Used by MetadataBuilder and SeoMetadataManager for og:description, twitter:description,

/// and Schema.org description properties.

/// </remarks>

public string Description

{

get

{

return this.description;

}

set

{

base.SetValue("Description", value, ref this.description);

}

}

/// <summary>

/// Gets if the Post have been changed.

/// </summary>

public override bool IsChanged

{

get

{

if (base.IsChanged)

{

return true;

}

if (this.Categories.IsChanged || this.Tags.IsChanged || this.NotificationEmails.IsChanged)

{

return true;

}

return false;

}

}

/// <summary>

/// Gets the next post relative to this one based on time.

/// <remarks>

/// If this post is the newest, then it returns null.

/// </remarks>

/// </summary>

public Post Next { get; private set; }

/// <summary>

/// Gets a collection of email addresses that is signed up for

/// comment notification on the specific post.

/// </summary>

public StateList<string> NotificationEmails

{

get

{

return this.notificationEmails;

}

}

/// <summary>

/// Gets the absolute permanent link to the post.

/// </summary>

public Uri PermaLink

{

get

{

return new Uri($"{Blog.AbsoluteWebRoot}post.aspx?id={Id}");

//return new Uri(string.Format("{0}post/{1}", this.Blog.AbsoluteWebRoot, this.Slug));

}

}

/// <summary>

/// Gets the previous post relative to this one based on time.

/// <remarks>

/// If this post is the oldest, then it returns null.

/// </remarks>

/// </summary>

public Post Previous { get; private set; }

/// <summary>

/// Gets or sets a value indicating whether or not the post is published.

/// </summary>

public bool IsPublished

{

get

{

return this.isPublished;

}

set

{

base.SetValue("IsPublished", value, ref this.isPublished);

}

}

/// <summary>

/// Gets or sets a value indicating whether or not the post is deleted.

/// </summary>

public bool IsDeleted

{

get

{

return this.isDeleted;

}

set

{

base.SetValue("IsDeleted", value, ref this.isDeleted);

}

}

/// <summary>

/// Gets or sets the number of raters or the object.

/// </summary>

public int Raters

{

get

{

return this.raters;

}

set

{

base.SetValue("Raters", value, ref this.raters);

}

}

/// <summary>

/// Gets or sets the rating or the post.

/// </summary>

public float Rating

{

get

{

return this.rating;

}

set

{

base.SetValue("Rating", value, ref this.rating);

}

}

/// <summary>

/// Gets the absolute link to the post.

/// </summary>

public Uri AbsoluteLink

{

get

{

return new Uri(this.Blog.AbsoluteWebRootAuthority + this.RelativeLink);

}

}

/// <summary>

/// Gets a relative-to-the-site-root path to the post.

/// Only for in-site use.

/// </summary>

public string RelativeLink

{

get

{

// taking into account aggregated posts

var settings = BlogSettings.GetInstanceSettings(Blog);

var ext = string.IsNullOrEmpty(BlogConfig.FileExtension) ? ".aspx" : BlogConfig.FileExtension;

var theslug = Utils.RemoveIllegalCharacters(this.Slug);

if (!settings.RemoveExtensionsFromUrls)

theslug += ext;

var BlogUrl = "";

if (this.BlogId != Blog.CurrentInstance.Id)

{

// point it to child blog

BlogUrl = this.Blog.Name + "/";

}

return settings.TimeStampPostLinks

? string.Format("{0}{1}post/{2}{3}", Blog.RelativeWebRoot, BlogUrl, DateCreated.ToString("yyyy/MM/dd/", CultureInfo.InvariantCulture), theslug)

: string.Format("{0}{1}post/{2}", Utils.RelativeWebRoot, BlogUrl, theslug);

}

}

/// <summary>

/// Returns a relative link if possible if the hostname of this blog instance matches the

/// hostname of the site aggregation blog. If the hostname is different, then the

/// absolute link is returned.

/// </summary>

public string RelativeOrAbsoluteLink

{

get

{

return Blog.DoesHostnameDifferFromSiteAggregationBlog ? AbsoluteLink.ToString() : RelativeLink;

}

}

/// <summary>

/// Gets or sets the Slug of the Post.

/// A Slug is the relative URL used by the posts.

/// </summary>

public string Slug

{

get

{

return string.IsNullOrEmpty(this.slug) ? GetUniqueSlug(this.title, this.Id) : this.slug;

}

set

{

base.SetValue("Slug", value, ref this.slug);

}

}

/// <summary>

/// Gets an unsorted collection of tags.

/// </summary>

public StateList<string> Tags

{

get

{

return this.tags;

}

}

/// <summary>

/// Gets or sets the Title or the post.

/// </summary>

public string Title

{

get

{

return this.title;

}

set

{

base.SetValue("Title", value, ref this.title);

}

}

/// <summary>

/// Gets the trackback link to the post.

/// </summary>

public Uri TrackbackLink

{

get

{

return new Uri($"{Blog.AbsoluteWebRoot}trackback.axd?id={Id}");

}

}

/// <summary>

/// Gets a value indicating whether or not the post is visible or not.

/// </summary>

public bool IsVisible

{

get

{

if (this.IsDeleted)

return false;

else if (this.IsPublished && this.DateCreated <= BlogSettings.Instance.FromUtc())

return true;

else if (Security.IsAuthorizedTo(Rights.ViewUnpublishedPosts))

return true;

return false;

}

}

/// <summary>

/// Gets a value indicating whether a post is available to visitors not logged into the blog.

/// </summary>

public bool IsVisibleToPublic

{

get

{

return (this.IsPublished && this.IsDeleted == false &&

this.DateCreated <= BlogSettings.Instance.FromUtc());

}

}

/// <summary>

/// URL of the first image in the post, if any.

/// If there's no first image, returns an empty string.

/// </summary>

public string FirstImgSrc

{

get

{

string srcValue = null;

if (!string.IsNullOrEmpty(content))

{

Match match = Regex.Match(content, @"<img\s+?.*?src=('|"")(.*?)\1.*?>", RegexOptions.Multiline | RegexOptions.IgnoreCase);

if (match.Success)

{

srcValue = match.Groups[2].Value;

}

}

return srcValue ?? string.Empty;

}

}

#endregion

#region SEO & GEO (Generative Engine Optimization) Properties

/// <summary>

/// Gets or sets the canonical URL for this post.

/// </summary>

/// <remarks>

/// UNIFIED METADATA: Part of the unified SEO/GEO model.

/// The canonical URL is used to prevent duplicate content penalties in search engines

/// and to establish the primary URL identity for this specific post when duplicated elsewhere.

/// Also helps AI systems identify the authoritative source.

/// </remarks>

public string CanonicalUrl

{

get { return this.canonicalUrl; }

set { base.SetValue("CanonicalUrl", value, ref this.canonicalUrl); }

}

/// <summary>

/// Gets or sets the Schema.org type for structured data markup.

/// </summary>

/// <remarks>

/// UNIFIED METADATA: Part of the unified SEO/GEO model.

/// Specifies the schema type for this post (e.g., "BlogPosting", "Article", "NewsArticle").

/// Used in structured data to help search engines and AI systems understand the content type.

/// Defaults to "BlogPosting" if not specified.

/// </remarks>

public string SchemaType

{

get { return this.schemaType; }

set { base.SetValue("SchemaType", value, ref this.schemaType); }

}

/// <summary>

/// Gets or sets comma-separated key entities mentioned in the post.

/// </summary>

/// <remarks>

/// UNIFIED METADATA: Part of the unified SEO/GEO model (GEO-focused).

/// A comma-separated list of named entities (people, organizations, locations, concepts)

/// mentioned in the post content. Used by AI systems for entity extraction and semantic understanding.

/// Example: "Machine Learning, Neural Networks, TensorFlow"

/// </remarks>

public string KeyEntities

{

get { return this.keyEntities; }

set { base.SetValue("KeyEntities", value, ref this.keyEntities); }

}

/// <summary>

/// Gets or sets a semantic summary optimized for AI systems.

/// </summary>

/// <remarks>

/// UNIFIED METADATA: Part of the unified SEO/GEO model (GEO-focused).

/// A concise, semantically rich summary that emphasizes key concepts and relationships

/// for better understanding by generative AI systems. Unlike traditional meta descriptions,

/// this should highlight semantic meaning and entity relationships.

/// </remarks>

public string SemanticSummary

{

get { return this.semanticSummary; }

set { base.SetValue("SemanticSummary", value, ref this.semanticSummary); }

}

/// <summary>

/// Gets or sets the Main Subject Line (MSL) for content classification.

/// </summary>

/// <remarks>

/// UNIFIED METADATA: Part of the unified SEO/GEO model (GEO-focused).

/// The primary subject or main topic of the post content, used for topic modeling

/// and content categorization by AI systems. Should be a single, clear phrase representing

/// the post's main subject (e.g., "Cloud Computing Best Practices").

/// </remarks>

public string ContentMSL

{

get { return this.contentMSL; }

set { base.SetValue("ContentMSL", value, ref this.contentMSL); }

}

/// <summary>

/// Gets or sets comma-separated meta keywords for search engines and AI systems.

/// </summary>

/// <remarks>

/// UNIFIED METADATA: Part of the unified SEO/GEO model.

/// Keywords that describe the post content for search engines and AI-powered search systems.

/// Use comma-separated values. Modern search engines may give less weight to this field,

/// but it remains useful for AI systems and specialized search applications.

///

/// CONSOLIDATED FIELD: This is the unified storage for all keyword metadata in the Post model.

///

/// BACKWARD COMPATIBILITY: This property provides explicit keyword metadata control.

/// Falls back to Tags collection if not explicitly set. MetadataBuilder automatically

/// uses this field when set, or falls back to Tags when empty.

///

/// Usage: Set this when you need fine-grained control over SEO keywords that differs

/// from your taxonomy Tags. Leave empty to use Tags as the default keyword source.

/// </remarks>

public string MetaKeywords

{

get

{

// If MetaKeywords not explicitly set, fall back to Tags for backward compatibility

if (string.IsNullOrEmpty(this.metaKeywords) && this.Tags != null && this.Tags.Count > 0)

{

return string.Join(", ", this.Tags);

}

return this.metaKeywords;

}

set { base.SetValue("MetaKeywords", value, ref this.metaKeywords); }

}

/// <summary>

/// Gets or sets meta robots directives for search engine crawling behavior.

/// </summary>

/// <remarks>

/// UNIFIED METADATA: Part of the unified SEO/GEO model.

/// Controls how search engine crawlers and AI indexers should treat this post.

/// Common values: "index, follow", "noindex, follow", "index, nofollow", "noindex, nofollow".

/// Extended GEO directives: "noai", "noimageai" to opt-out of AI training/generation.

/// Used to include/exclude content from search results and AI training data.

/// </remarks>

public string MetaRobots

{

get { return this.metaRobots; }

set { base.SetValue("MetaRobots", value, ref this.metaRobots); }

}

/// <summary>

/// Gets or sets Open Graph metadata (JSON serialized).

/// </summary>

/// <remarks>

/// UNIFIED METADATA: Part of the unified SEO/GEO model.

/// JSON-formatted Open Graph metadata for social media sharing and rich previews.

/// Includes properties like og:title, og:description, og:image, og:type, etc.

/// Improves how posts appear when shared on social media and messaging platforms.

/// USAGE PATTERN: This field is for CUSTOM OVERRIDES only. By default, SeoMetadataManager

/// generates OG tags from other metadata properties. Use this only when you need to override

/// default OG tag generation with custom values.

/// </remarks>

public string OpenGraphData

{