Metadata-Version: 1.1
Name: stopforumspam
Version: 1.1
Summary: Django middleware for blocking IPs listed in stopforumspam.com
Home-page: https://overtag.dk/
Author: Benjamin Bach
Author-email: benjamin@overtag.dk
License: BSD License
Description: ###############################
        django stopforumspam middleware
        ###############################
        
        A django application that provides middleware for blocking IPs listed in
        stopforumspam.com's database.
        
        A management command is provided for updating the database:
        
        manage.py sfsupdate [--force]
        
        ...and all IPs are stored in Django models so you can add your own as well
        (remember to mark them permanent so they don't get deleted!)
        
        ************
        Installation
        ************
        
        At the moment there is no updated packages, so install directly from github using:
        
            pip install git+git://github.com/benjaoming/django-stopforumspam.git
        
        The old release was installed by running:
        
            sudo pip install stopforumspam
        
        Add this to settings.MIDDLEWARE_CLASSES
        
            'stopforumspam.middleware.StopForumSpamMiddleware'
            
        Then add this to INSTALLED_APPS
        
            'stopforumspam'
        
        And run
        
            ./manage.py syncdb
        
        To insert all the IPs run this command, which you should make a cronjob (run it every 24h).
        
            ./manage.py sfsupdate
        
        You may remove stopforumspam from your INSTALLED_APPS after, if you do not
        wish to see it in your admin pages.
        
        
        *************
        Configuration
        *************
        
        The following options exist for your project's settings.py file:
        
        To check ALL POST requests:
        
            SFS_ALL_POST_REQUESTS = True
        
        To ignore some URLS:
        
            SFS_URLS_IGNORE = ["url_name", "/url/path"]
        
        To only include some URLS (only works if SFS_ALL_POST_REQUEST=False):
        
            SFS_URLS_INCLUDE = ["url_name", "/url/path"]
        
        To configure where to download the file from (you can MAX download 2 times a day) - see http://www.stopforumspam.com for more resources:
        
            SFS_SOURCE_ZIP = "http://www.stopforumspam.com/downloads/listed_ip_7.zip"  
        
        Remember to configure this as well -- it's the name of the file inside the .zip file:
        
            SFS_ZIP_FILENAME = "listed_ip_7.txt"
        
        For testing you can force all requests to be checked.
        
            SFS_FORCE_ALL_REQUESTS = True   
        
        *************
        Cron Jobs
        *************
        You probably want to automatically update the list of blocked IP addresses every 24 hours or 48 hours.
        To do that, you can insert a line in crontab.
        
            0 2 * * * cd /your/project/path/ && python manage.py sfsupdate
        
        The above would update at 2 AM every night.
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
