= Django source code repository and wiki = Django is available open-source under the [http://code.djangoproject.com/file/django/trunk/LICENSE BSD license]. == Browsing code online == * [/browser/django/trunk/ Browse source]: See the full code via a Web interface. * [/timeline/ Timeline]: Keep track of recent changes. * See our [http://www.djangoproject.com/download/ download page] for download instructions. == Getting involved == * [http://www.djangoproject.com/documentation/contributing/ How to contribute to Django]: The lowdown on how our community works. * [report:1 Tickets]: View active tickets, make bug reports and contribute feature requests. * [wiki:LittleEasyImprovements Little, easy improvements]: Get your feet wet by taking on one of these small tasks. == Heads up == Django's development version is always being worked on, which means that from time to time there are things that won't work for a while because they're being updated, and new features will be introduced which take a little time to stabilize. Some of them are listed here: * [wiki:ModelInheritance]: Write-up discussing how inheritance/subclassing of models should work. Currently this is not implemented in the development version of Django, so if you need model subclassing stick to one of the older stable releases or use workarounds like one-to-one relationships. * [wiki:SchemaEvolution]: This is a new feature, under development as a project for the 2006 Summer of Code. * [wiki:GenericAuthorization]: Currently Django's permission system only works at the level of an entire model -- e.g., user "Bob" has access to add flatpages and edit users. This Summer of Code project will extend the permission system to be much more fine-grained, so permissions will be able to be assigned per object instead of per model (so, for example, user "Bob" could be given permission to edit only flatpage number 24 and user number 12, instead of all flatpages and all users). * Multiple authentication backends: the [http://code.djangoproject.com/browser/django/branches/multi-auth multi-auth branch] of Django, currently under development, is abstracting the authentication backend to make it easier to use other authentication systems like LDAP. Check out the [http://code.djangoproject.com/browser/django/branches/multi-auth/docs/authentication.txt#L677 documentation] to see how this will work. == Descriptions of major changes to the codebase == * [wiki:BackwardsIncompatibleChanges Backwards Incompatible Changes]: Comprehensive list of backwards-incompatible changes made since first public release. * [wiki:RemovingTheMagic Removing the magic]: The magic-removal branch was merged to trunk in changeset [2809], May 2006. * [wiki:NewAdminChanges New-admin changes]: The new-admin branch was merged to trunk in changeset [1433], November 2005. == Example applications (with source code/templates) == * [/browser/djangoproject.com/django_website/ djangoproject.com]: See the full code and templates for the Django-powered portions of this site (i.e., everything except the ticket system). The Python code is available under the BSD license, but the templates are copyrighted by World Online and shouldn't be copied. * [https://svn.greenpeace.org/viewvc/viewcvs.py/custard/production/ Custard/Melt]: Source code for application developed using Django. * [http://simon.bofh.ms/cgi-bin/trac-django-projects.cgi/wiki/DjangoGallery Django Photo Gallery ] : Source for a "Gallery with a twist" (by Georg Bauer) * [http://simon.bofh.ms/cgi-bin/trac-django-projects.cgi/wiki/CmsProject Source for A simple CMS] : written with Django (Georg Bauer) ( A site [http://rfc1437.de/] : using this simple CMS system.) * [http://simon.bofh.ms/cgi-bin/trac-django-projects.cgi/wiki/CmsProject Source for an IRCLogger] : done in Django (Georg Bauer) * [http://workstyle-py.sourceforge.net/ WorkStyle] - GTD TODO Management Application. [http://django.everes.net/WorkStyle/ sandbox] is available too. * [http://zyons.com Zyons] - Forum/Community application. * [http://www.carcosa.net/jason/software/django/stockphoto/ stockphoto] - A simple photo gallery (by Jason !McBrayer) * [http://tabo.aurealsys.com/software/feedjack/ Feedjack] - A Planet/feed aggregator application by Gustavo Picón. Sample sites: ([http://www.chichaplanet.org/ 1], [http://gnome.chichaplanet.org 2], [http://debian.chichaplanet.org 3]) * [http://paste.e-scribe.com/ Generic Pastebin App] - An application completely driven by generic views, no custom view code. Source links available in upper right corner of any page. == Sites using Django == * [wiki:DjangoPoweredSites Django-powered sites] : List your Django powered site(s) here! == Code extras == * [wiki:ContributedMiddleware User-contributed middleware] * [http://www.zope.org/Members/shh/DjangoPageTemplates Zope3 Page Templates for Django] * [http://126.pl/cheetah.tar.bz2 Cheetah template for django]: Generic views + cheetah's admin functions. Contact dj@126.pl. * [http://djangoutils.python-hosting.com/ Djangoutils]: Trac/Subversion with miscellaneous Django utilities (thumbnails, [http://www.bosrup.com/web/overlib/ overLIB] support, admin utilities). * [wiki:ScaffoldScript Simple 'scaffolding']: Spew out simple form fields as a base for modification * [wiki:ManipulatorScript Simple Custom Manipulators]: Spews out a custom manipulator for your model, primed and ready for tweaking. * [wiki:ModelMiddleware Model 'middleware']: Add pre/post save/delete callbacks to any model. == User-contributed documentation == * [wiki:ServerArrangements Server arrangements]: How to use Django with FCGI, Twisted, etc. * CookBook: Code recipes. * CommonPitfalls: Common developer errors, gotchas, etc. * DocumentationSuggestions: A place to put docs that you wish ''you'' could have found while learning * [wiki:DosAndDontsForApplicationWriters Do's and Dont's for application writers]: how to make an application that is easy to distribute * DjangoScreencasts: Official and unofficial screencasts showing Django development in action. * [http://itmaurer.com/clepy/htdocs/media/presentation/presentation.html Python Web development with Django]: A presentation in pseudo-!PowerPoint format that provides a good overview. * [wiki:SimpleBashScriptToSetupDevelopmentEnvironment Simple Bash Script To Setup Development Environment]: An example of how to set up your development environment. * [wiki:DjangoSettingsBashFunction 'django-settings' Bash function]: Save the typing of DJANGO_SETTINGS_MODULE. * ExtendedUserModel: How to extend the auth systems's User class to contain extra data. (Warning: kludge!) * [wiki:UsingVimWithDjango Django development with Vim]: Hints and tips for using the Vim editor. * [wiki:SnakesAndRubiesTranscript Snakes and Rubies Transcript]: Currently a partial transcript of the Snakes and Rubies meeting videos. * [wiki:WebServices WebServices]: An example showing how to access a web service (Amazon.com) using Python. * [wiki:PythonScriptForParsingSettings A python script for parsing settings.py]: A small python script can be used to read, modify, save settings.py file. * [wiki:PythonScriptForParsingUrlConf A python script for parsing urls.py]: A small python script can be used to read, modify, save urls.py file. * [wiki:ChineseDjangoTutorial Chinese Django Tutorial]: A Chinese Django tutorial step by step. * [wiki:SetupOnTiger Setup on Mac OS X Tiger]: Includes installing python 2.4 (which isn't required), the latest version of postgresql, and psycopg. * [wiki:CustomFormFields Making Custom form fields]: Adventures in making new form fields * [http://djangoapi.quamquam.org/ Django API (Beta)]: Automatic generated API using epydoc * [wiki:ProfilingDjango Profiling Django]: How to use the Python hotshot profiler with Django * ExtendingAdminTemplates * FormField documentation for Manipulators * [wiki:XML-RPC] Example of doing XML-RPC in Django * [wiki:AjaxDjangoDojoForm Ajax and Django, using Dojo + SimpleJson] How to submit a form using Ajax with Dojo and Json. * [wiki:UsingFreeComment FreeComment app] Using Django integrated Free Comment app. * [wiki:WindowsInstall] - install django on Windows in 5 minutes (using sqlite and the internal webserver) == Under discussion == * [wiki:ModelInheritance Model Inheritance]: Subclassing and model inheritance. * [wiki:VersionOneFeatures Version One features] * [wiki:Localization Localization (l10n)] * [wiki:UnicodeInDjango Streamlining Unicode Usage] * [wiki:AJAX AJAX and Django] * [wiki:BetterErrorMessages Better Error Messages]: Documenting situations where better error messages would improve the experience of developing with Django * [wiki:MultipleDatabaseSupport Muliple Database Support]: Adding support for multiple database connections == Community == * [wiki:DevelopersForHire Developers for hire]: Community members available to do Django work. * [wiki:DjangoFriendlyWebHosts Django-friendly Web hosts] * [http://www.djangoproject.com/community/badges/ Official Django badges] * [http://www.djangoproject.com/community/logos/ Official Django logos] * [wiki:DjangoUsers DjangoUsers]: User community about django