The document describes the 'Spaces' API module for Drupal, which allows for configurable site sections and features specific to individual spaces on a website. It outlines various functionalities, such as space types, features integration, and the use of persistent URLs (PURL) to manage navigation and content. Additionally, it lists potential use cases and projects utilizing the module.

1. Using Spaces
Stijn De Meyere

2. Topics
• Spaces in general
• Space types
• Spaces + PURL
• Space controllers
• Features integration
• Use cases
2

3. What is spaces?
http://drupal.org/project/spaces
3

4. From the project page
Spaces is an API module intended to make
configuration options generally avaliable
only at the sitewide level to be configurable
and overridden by individual "spaces" on a
Drupal site.
4

5. My description
Spaces is an API module that introduces
context to your site, effectively allowing you
to load different configuration.
5

6. What does this mean?
• Abstract API
• No real UI
• For developers
6

7. What’s it good for?
• Create site sections
• Set up multiple sites with or without shared content
• Create private/public groups
• Give editor/admin rights to certain users on certain
parts of the site
• Enable different features based on the active
space
• ...
7

8. The Magic
spaces_load('space_type', 'id')->activate();
8

9. The Magic
$space = spaces_get_space();
9

10. The Magic
$space->deactivate();
10

11. Space types
11

12. Space types
• Trigger (not as in actions)
• A property, anything you want
• Plugin based (ctools)
• Extend base types
12

13. Provided space types
• Organic Groups
• Taxonomy
• User
13

14. Spaces + PURL
http://drupal.org/project/purl
14

15. PURL
Persistent URL
It is meant to be a helper for other modules
interested in using elements of the page
request to sustain information between
pages without using a SESSION or other
hackish means.
15

16. PURL Providers
• Path prefixes: http://example.com/foo/node/5
• Path prefix pairs: http://example.com/group/1/node/5
• Query string: http://example.com/node/5?group=1
• Domains: http://example.com/node/5
• Subdomains: http://foo.example.com/node/5
• Path Extensions: http://example.com/node/5.csv
(detection only, no rewriting)
• HTTP User Agent: Mozilla/5.0 (iPhone; U; CPU like
Mac OS X; en) (detection only, no rewriting)
16

17. PURL
• Rewrite link
• hook_url_inbound_alter()
• hook_url_outbound_alter()
17

18. The Magic
$options = array(
'purl' => array(
'provider' => 'purl_provider',
'id' => 5
),
);
18

19. The Magic
$options = array(
'purl' => FALSE,
);
19

20. Spaces + PURL
• extend space_type_purl
• Keeps a space alive
20

21. Space controllers
21

22. Space controllers
Provides a way to manage configuration for
each space.
22

23. Space controllers
Configuration that lives, or can live, in code can
be overruled.
(or basically: anything that comes with a hook or a
drupal_alter can become space dependent)
23

24. Configuration stack
site > preset > space
24

25. Configuration stack
site > preset > space
site > preset > space > user
25

26. Implemented controllers
• Variable
• Context
• (menu reorder)
26

27. Spaces + Features
27

28. Spaces + Features
• A special controller to manage features in a
space
• Disable / Enable a feature without touching the
feature module
• Provide configuration for your feature
28

29. The Magic
spaces[types] = "all"
spaces[types] = "og"
spaces[types] = "user"
29

30. Spaces Dashboard
Provides a feature to create/configure a
dashboard per space.
30

31. Obligatory screenshot
31

32. Use Cases
32

33. Open Atrium
http://openatrium.com/
33

34. Belgian Beer Weekend
http://belgianbeerweekend.jp
34

35. Belgian Beer Weekend
http://belgianbeerweekend.jp
35

36. Belgian Beer Cafe
http://www.belgianbeercafe.com/
36

37. Belgian Beer Cafe
http://www.belgianbeercafe.com/
37

38. Mystery project
• Launch with 200+ microsites
• Grow up to 800+ microsites
• Lots of shared content (± 30 pages/microsite)
• Authors & editors per microsite, top-level
moderators
• Custom entity
• Whitelabling
38

39. @stijndm
freelance Drupal dev
39

40. Feedback & follow-up:
http://drupalcampgent.be/feedback