Browse files

[1.2.X] Fixed #12812 -- added warning about cyclic imports in contrib…

….comments. Thanks to Beetle_B, bjourne and philgyford for the reports, and Russ for the wording.

Backport of r14810 from trunk.

git-svn-id: bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information...
1 parent 6c53a81 commit 65b26b30a760330aac94bf2cdaa4d18f337c875e @DrMeers DrMeers committed Dec 4, 2010
Showing with 12 additions and 0 deletions.
  1. +12 −0 docs/ref/contrib/comments/custom.txt
@@ -110,6 +110,18 @@ point Django at these classes we've created::
def get_form():
return CommentFormWithTitle
+.. warning::
+ Be careful not to create cyclic imports in your custom comments app.
+ If you feel your comment configuration isn't being used as defined --
+ for example, if your comment moderation policy isn't being applied --
+ you may have a cyclic import problem.
+ If you are having unexplained problems with comments behavior, check
+ if your custom comments application imports (even indirectly)
+ any module that itself imports Django's comments module.
The above process should take care of most common situations. For more
advanced usage, there are additional methods you can define. Those are
explained in the next section.

0 comments on commit 65b26b3

Please sign in to comment.