Confluence Connect has added APIs and enhanced macros – but we didn't stop there. We've also introduced new types of add-ons: theming, workflows, and custom content. Confluence product manager Brian Swift will cover each of these, including the building blocks you'll need and examples of how to use them. He'll also show you how to integrate these types of add-ons with Confluence features to provide a great experience for users. There's never been a better time to create add-ons to satisfy more Confluence use cases! Ben Mackie, Head of Confluence Engineering, Atlassian Brian Swift, Principal Product Manager, Atlassian

1. Back to the Confluence Future
BRIAN SWIFT | PRODUCT MANAGER BEN MACKIE | HEAD OF ENGINEERING
What’s New with Confluence Connect

2. HIGHLIGHTS
100 million plus
pages created

3. HIGHLIGHTS
A shiny new
Confluence

4. Real-time
collaborative
editing
HIGHLIGHTS

5. HIGHLIGHTS
Work together
from wherever

6. Over 100 add-ons
for Confluence
Cloud
HIGHLIGHTS

7. “Need more add-ons for Cloud instances -
I cry a little bit every time I see an
awesome add-on that is server only
(sadpanda)
HEARTBROKEN CUSTOMER

8. How can you plug-in to the future?

9. The future is already here -
it’s just not very evenly
distributed.
WILLIAM GIBSON

10. The Future of Work
is incredibly hard to predict.

11. Present
Trends and technologies are
beginning to emerge.
A journey through time
Future
Envision what we can build
together.
Past
Use past learnings to improve
our understanding

12. A JOURNEY THROUGH TIME
Custom
Content
Connect
Launch
Content REST
API
CQL
Macros and
Blueprints 2.0
New Developer
Experience
Theming
Workflows
???
2014 Today

13. A JOURNEY THROUGH TIME
Custom
Content
Connect
Launch
Content REST
API
CQL
Macros and
Blueprints 2.0
New Developer
Experience
Theming
Workflows
???
2014 Today

14. Agenda
Cloud, Creators and Consumers
Content Apps
Integrated Services
What it means for YOU

15. Agenda
Cloud, Creators and Consumers
Content Apps
Integrated Services
What it means for YOU

16. “Marty, I'm sorry, but the only power
source capable of generating 1.21
gigawatts of electricity is a bolt of
lightning.
DOC BROWN

17. INSIDERS AND OUTSIDERS
Insiders Outsiders

18. INSIDERS AND OUTSIDERS

19. Theming
Descriptor
View Page
Select Theme

20. Theming
"confluenceThemes": [{
"routes": {
"spaceview": { "url": "/my-spaceview/{space.key}" }
},
"icon": { "url": "/my-theme-icon.png" },
"description": { "value": "My Amazing Theme" },
"lookAndFeel": { … },
"name": { "value": "My Theme" },
"key": "my-addon-theme"
}]
Descriptor
View Page
Select Theme

21. Theming
"lookAndFeel": {
"headings": { "color": "#333333" },
"links": { "color": "#3572B0" },
"menus": { … },
"header": { … },
"primaryNavigation": { … },
"secondaryNavigation": { … },
"search": { … }
"content": { … }
}
Descriptor
Select Theme
View Page

22. Theming
Descriptor
Select Theme
View Page

23. Theming
Descriptor
Select Theme
View Page

24. Page Extensions
Descriptor
Example

25. "contentBylineItems": [
{
"context": "addon",
"target": { "type": "inlinedialog" },
"tooltip": { "value": "Approvals" },
"icon": { "url": "/images/approval.png" },
"name": { "value": "Page Approvals" },
"key": "byline-item",
"url": "/approvals?contentId={content.id}"
}
]
Page Extensions
Descriptor
Example

26. Page Extensions
Descriptor
Example

27. Page Extensions
By Line Item
An Add-on can add extend
the by line to present “Page
Level” information to the user.
Descriptor
Example

28. Page Extensions
Descriptor
Example

29. Two models of publishing
Space
publishing
Publishing a master restricted
space to another “published” space
Version
publishing
Different users see a different version
of the one page depending on their
group membership

30. Space
Publishing
Space
Permissions
Copy Page Tree
Embedded
content
Space Permissions API
POST : /rest/api/space
{
"key" : "DOC",
"name" : "Documentation Space",
"permissions" : [{
"operation" : {
"targetType" : "create",
"operation" : "page"
},
"subjects" : {
"group" : [{
"type" : "group",
"name" : "tech-writers"
}],
"user" : [{
"type" : "user",
"username" : "kateww"
}],
},
"anonymousAccess" : "false",
"unlicensedAccess" : "false"
}]

31. Space
Publishing
Copy Page Tree API
POST /content/pagehierarchy/copy
{
"copyAttachments" : "true",
"copyPermissions" : "true",
"copyLabels" : "true",
"originalPageId" : {
"id" : "491592"
},
"destinationPageId" : {
"id" : "65736"
},
"titleOptions" : {
"prefix" : "Latest",
"replace" : "Previous",
"search" : "abc"
}
}
Space
Permissions
Copy Page Tree
Embedded
content

32. Space
Publishing
Embedded content API
GET : /rest/api/content/123?expand=body.view.embeddedContent
{
"id" : "123",
"type" : "page",
"title" : "Page with embedded content",
"body" : {
"view" : {
"value" : "...",
"representation" : "VIEW",
"embeddedContent" : [{
"entity" : {
"id" : "9999",
"type" : "page",
"status" : "current",
"title" : "Embedded page"
}
}
Space
Permissions
Copy Page Tree
Embedded
content

33. Version
Publishing
Embedded
content
Version interception
Version
Interception
Add-on owned
content
properties
PUT : /rest/api/content/123/property/atl-view-property
{
"key" : "atl-version-view",
"value" : {
"versionProperties" : [{
"version" : "5",
"group" : "confluence-administrators"
},
{
"version" : "3",
"group" : "confluence-users"
},
{
"version" : "1",
"group" : "*"
}]
}
}

34. Version
Publishing
Embedded content rendering
GET
/rest/api/content/123?expand=body.view&embeddedContentRender=version-at-save
Embedded
content
Version
Interception
Add-on owned
content
properties

35. Version
Publishing
Secure content properties
Coming soon!
Add-ons will be able to register content properties
and then only the add-on user can modify them
Embedded
content
Version
Interception
Add-on owned
content
properties

36. What can you see that on one else can?

37. Agenda
Cloud, Creators and Consumers
Content Apps
Integrated Services
What it means for YOU

38. “Where we’re going,
we don’t need roads.
DOC BROWN

39. THE CORE OF CONFLUENCE
Pages Spaces

40. OUR BUILDING BLOCKS
Pages
Content collaboration for
every team in an
organisation
Content Apps
Content collaboration for
specific functions in an
organisation

45. YOUR ADD-ON

46. YOUR ADD-ON
Build your own Content App experience

47. Custom
Content
Descriptor
uiSupport
apiSupport

48. Custom
Content
"customContent": [{
"key": "issue",
"name": { "value": "Issues" },
"uiSupport": { … },
"apiSupport": { … }
}]
Descriptor
uiSupport
apiSupport

49. Custom
Content
"uiSupport": {
"contentViewComponent": {
"moduleKey": "view-issue"
},
"listViewComponent": {
"moduleKey": "list-issues"
},
"icons": {
"item": { "url": "/images/customers.png" }
}
}
Descriptor
uiSupport
apiSupport

50. Custom
Content
Descriptor
uiSupport
apiSupport

51. Custom
Content
"apiSupport": {
"bodyType": "storage",
"supportedContainerTypes": [ "space" ],
"supportedChildTypes": [ "comment" ],
"preventDuplicateTitle": false,
"indexing": {
"enabled": true
}
}
Descriptor
uiSupport
apiSupport

52. Custom
Content
Space
Issue
Comment
Descriptor
uiSupport
apiSupport

53. What vertical of customer can you best serve?

54. Agenda
Cloud, Creators and Consumers
Content Apps
Integrated Services
What it means for YOU

55. “Your kids are gonna love it.
MARTY MCFLY

56. INTEGRATED SERVICES

57. INTEGRATED SERVICES

58. INTEGRATED SERVICES
Content worth
collaborating
on

59. Macros
Descriptor
Example

60. "dynamicContentMacros": [
{
"key": "giphy-macro",
"name": { "value": "Giphy Macro" },
"url": "/gif-renderer?gifUrl={url}",
"description": { "value": "Display a Gif" },
"outputType": "block",
"bodyType": "none",
"parameters": [{
"identifier": "url",
"name": { "value": "URL" }
}]
}]
Macros
Descriptor
Example

61. Macros
Descriptor
Example

62. Macros
Descriptor
Example

63. Macros
Descriptor
Example

64. How can you get all team members using
your service?

65. Agenda
Cloud, Creators and Consumers
Content Apps
Integrated Services
What it means for YOU

66. The future is already here -
it’s just not very evenly
distributed.
WILLIAM GIBSON

67. Macros Page extensions Search Extensions
Blueprints Custom Content Theming

68. WHAT DO YOU SEE THAT NO ONE ELSE CAN?
Cloud, Creators
and Consumers
Content Apps Integrated Services

69. “When this baby hits 88 mph,
you’re gonna see some
serious s&#t!
DOC BROWN

70. Thank you!
BRIAN SWIFT | PRODUCT MANAGER BEN MACKIE | HEAD OF ENGINEERING