Basic Feature Flipper

Set the flag choices in your settings.py file as:

FEATURE_FLIPPER_FLAGS = (
  ('simple_feature', u'Simple Feature'),
  ('beta_testing', u'Beta Testing'),
)

When you add features, simply add flags here and your application will be able to access the new flags immediately.

Custom Feature Flipper

To customise the feature flipper you can just extend feature_flipper.models.AbstractFeatureFlipper with your own field. This provides a major advantage over the basic flipper by letting you determine your own reference for filtering out whether users get a feature or not.

First, extend the AbstractFeatureFlipper model:

from feature_flipper.models import AbstractFeatureFlipper


class MyFeatureFlipper(AbstractFeatureFlipper):
  """
  """
  USER_FEATURE_FIELD = 'company'

  company = models.ForeignKey('myapp.Company')

The USER_FEATURE_FIELD sets the field that should be used for lookups when determining whether to show the feature to a user. The final part is to reference this in your settings.py:

FEATURE_FLIPPER_MODEL = 'myapp.MyFeatureFlipper',

The feature tag

The feature template tag is a simple template tag that takes two arguments:

1. The user requesting access

2. The feature string to check for

For custom feature flippers, the user argument is simply the alternative user identifier, for example the user’s organisation.