From 936bb03d7e486caca5076deb594ede928389ca36 Mon Sep 17 00:00:00 2001
From: Shaked Klain <pigiman@gmail.com>
Date: Thu, 7 Nov 2013 02:14:41 +0100
Subject: [PATCH] added the ability to override\force related_posts from the
 post's meta data

---
 related_posts/Readme.rst       |  8 +++++++
 related_posts/related_posts.py | 39 +++++++++++++++++++++++-----------
 2 files changed, 35 insertions(+), 12 deletions(-)

diff --git a/related_posts/Readme.rst b/related_posts/Readme.rst
index db97149..e72790f 100644
--- a/related_posts/Readme.rst
+++ b/related_posts/Readme.rst
@@ -17,3 +17,11 @@ For example::
         {% endfor %}
         </ul>
     {% endif %}
+
+
+You can also override related posts by using it as part of your post's meta data 'related_posts:'.
+The 'related_posts:' meta data works together with your existing slugs:
+
+    related_posts: slug1,slug2,slug3...slugN 
+
+N represents the RELATED_POSTS_MAX
diff --git a/related_posts/related_posts.py b/related_posts/related_posts.py
index 8199900..93dd045 100644
--- a/related_posts/related_posts.py
+++ b/related_posts/related_posts.py
@@ -13,23 +13,38 @@ def add_related_posts(generator):
     # get the max number of entries from settings
     # or fall back to default (5)
     numentries = generator.settings.get('RELATED_POSTS_MAX', 5)
-
     for article in generator.articles:
-        # no tag, no relation
-        if not hasattr(article, 'tags'):
-            continue
+        # set priority in case of forced related posts
+        if hasattr(article,'related_posts'):
+            # split slugs 
+            related_posts = article.related_posts.split(',')
+            posts = [] 
+            # get related articles
+            for slug in related_posts:
+                i = 0
+                for a in generator.articles:
+                    if i >= numentries: # break in case there are max related psots
+                        break
+                    if a.slug == slug:
+                        posts.append(a)
+                        i += 1
 
-        # score = number of common tags
-        scores = Counter()
-        for tag in article.tags:
-            scores += Counter(generator.tags[tag])
+            article.related_posts = posts
+        else:
+            # no tag, no relation
+            if not hasattr(article, 'tags'):
+                continue
 
-        # remove itself
-        scores.pop(article)
+            # score = number of common tags
+            scores = Counter()
+            for tag in article.tags:
+                scores += Counter(generator.tags[tag])
 
-        article.related_posts = [other for other, count 
-            in scores.most_common(numentries)]
+            # remove itself
+            scores.pop(article)
 
+            article.related_posts = [other for other, count 
+                in scores.most_common(numentries)]
 
 def register():
     signals.article_generator_finalized.connect(add_related_posts)
\ No newline at end of file