Creating Custom Actions within SharePoint
2 likes754 views
The document is a presentation on creating custom actions within SharePoint. It discusses what custom actions are, demonstrations of creating simple and more complex custom actions, hiding custom actions, custom action groups, and resources for additional information. The presenter is Geoff Varosky from Grace-Hunt LLC, and he provides examples and explanations of how to use custom actions to customize the SharePoint user interface.
More Related Content
What's hot (20)
Similar to Creating Custom Actions within SharePoint (20)
More from Geoff Varosky (12)
Recently uploaded (20)
Creating Custom Actions within SharePoint
- 1. Creating Custom Actionswithin SharePointGeoff Varosky
- 2. About MeGeoff Varosky MCP, MCTSSenior Solutions Developer for Grace-Hunt, LLC.Blog: http://www.geoffvarosky.comEmail: [email protected]: @gvaro
- 3. About Grace-HuntFounded in 2004Based in Hudson, MAPresence in North East, Mid Atlantic, and South East RegionsMicrosoft Gold PartnerSpecializing in SharePoint and Dynamics (CRM, SL, GP, NAV) Consulting, Implementation, and IntegrationWeb: http://www.grace-hunt.comTwitter: @gvaroEmail: [email protected]: www.geoffvarosky.comCompany: www.grace-hunt.com
- 4. AgendaWhat are Custom Actions?DemonstrationsCreating a Simple Custom ActionAnatomy of a Custom ActionCreating a Slightly More Complex Custom ActionHiding Custom ActionsCustom Action GroupsReferencesQ&ATwitter: @gvaroEmail: [email protected]: www.geoffvarosky.comCompany: www.grace-hunt.com
- 5. ExamplesToolbarsTwitter: @gvaroEmail: [email protected]: www.geoffvarosky.comCompany: www.grace-hunt.com
- 6. ExamplesSite Actions MenuTwitter: @gvaroEmail: [email protected]: www.geoffvarosky.comCompany: www.grace-hunt.com
- 7. ExamplesSite SettingsTwitter: @gvaroEmail: [email protected]: www.geoffvarosky.comCompany: www.grace-hunt.com
- 8. ExamplesSite Settings (Custom Action Group)Twitter: @gvaroEmail: [email protected]: www.geoffvarosky.comCompany: www.grace-hunt.com
- 9. ExamplesEdit Control Block (ECB)Twitter: @gvaroEmail: [email protected]: www.geoffvarosky.comCompany: www.grace-hunt.com
- 10. ExamplesCentral Administration PagesTwitter: @gvaroEmail: [email protected]: www.geoffvarosky.comCompany: www.grace-hunt.com
- 11. Just What Are Custom Actions?Per Microsoft –“A custom action represents a link, toolbar button, menu item, or any control that can be added to a toolbar or menu that a user sees. Custom actions can be bound to list type, content type, file type, or programmatic identifier (ProgID).”Source: http://snipurl.com/d8y70Twitter: @gvaroEmail: [email protected]: www.geoffvarosky.comCompany: www.grace-hunt.com
- 12. Just What Are Custom Actions?What does that mean?Bits of XMLDeployed via FeaturesCreate a Link within SharePointSpecific LocationJavaScript, AJAX, URLs, etc.Twitter: @gvaroEmail: [email protected]: www.geoffvarosky.comCompany: www.grace-hunt.com
- 13. Just What Are Custom Actions?What does that mean?Custom Actions can be bound to List TypesA Custom Action can be bound to a Document Library, but, may not be bound to a Task ListExample: Check In/Check OutTwitter: @gvaroEmail: [email protected]: www.geoffvarosky.comCompany: www.grace-hunt.com
- 14. Just What Are Custom Actions?What does that mean?Custom Actions can be bound to File TypesExample: ‘Edit in Microsoft Word’ bound to Word (.doc, .docx) document typesTwitter: @gvaroEmail: [email protected]: www.geoffvarosky.comCompany: www.grace-hunt.com
- 15. Just What Are Custom Actions?What does that mean?Custom Actions can be bound to Content TypesExample: Folders, Document Content Types, List Content Types, etc.Programmatic IdentifiersExample: Task List Identifier (107)http://snipurl.com/ntd5gTwitter: @gvaroEmail: [email protected]: www.geoffvarosky.comCompany: www.grace-hunt.com
- 16. What Can Custom Actions Do?But wait, there’s more!Twitter: @gvaroEmail: [email protected]: www.geoffvarosky.comCompany: www.grace-hunt.com
- 17. What Can Custom Actions Do?But wait, there’s more!Create links to pages that really should be there…Example: There is a link to the Site Collection Recycle Bin on the Site Settings page, however, there is no link to the current site Recycle Bin. (Demo #1)Custom Actions can pass along information to act uponExample: Add a “Complete Task” action to an Edit Control Block, which calls an ASPX page, taking the parameters of the List ID and Item ID, and updating the task item within a list. (Demo #2)Twitter: @gvaroEmail: [email protected]: www.geoffvarosky.comCompany: www.grace-hunt.com
- 18. What Can Custom Actions Do?…and moreCustom Actions can also be hiddenExample: You do not want site administrators to be able to delete their sites by using the Delete This Site link on the Site Settings page so, we can remove it by using HideCustomAction (Demo #3)Create Groupings of Custom Actions by using CustomActionGroupExample: Create a grouping of your Custom Actions on the Site Settings page for all of your Custom Actions… (Demo #4)Twitter: @gvaroEmail: [email protected]: www.geoffvarosky.comCompany: www.grace-hunt.com
- 19. What Tools Are Needed?NotepadWhat do I use?Visual StudioAndrew Connell’s SharePoint Project Utility for Visual Studiohttp://snipurl.com/d8yv9Requires DevExpress DX Core to be installed (free)WSPBuilder (CodePlex)http://snipurl.com/d8yxvSharePoint Solution Installer (CodePlex)http://snipurl.com/nt6uxTwitter: @gvaroEmail: [email protected]: www.geoffvarosky.comCompany: www.grace-hunt.com
- 20. DemoCreating a Simple Custom ActionView Demo: http://www.vimeo.com/9728285Twitter: @gvaroEmail: [email protected]: www.geoffvarosky.comCompany: www.grace-hunt.com
- 21. Anatomy of a Custom ActionFeature Definition (feature.xml)Twitter: @gvaroEmail: [email protected]: www.geoffvarosky.comCompany: www.grace-hunt.com
- 22. Anatomy of a Custom ActionScope Web
- 23. A “sub-site”
- 24. Only activates the feature on the specific web
- 25. Site
- 26. Site Collection
- 27. Applies to all webs within the site collection
- 28. Web Application
- 29. Applies to all site collections and webs within a web application
- 30. Farm
- 31. Applies to all web applications, site collections, etc.....Twitter: @gvaroEmail: [email protected]: www.geoffvarosky.comCompany: www.grace-hunt.com
- 32. Anatomy of a Custom ActionElement Manifest (manifest.xml)Twitter: @gvaroEmail: [email protected]: www.geoffvarosky.comCompany: www.grace-hunt.com
- 33. Anatomy of a Custom Action<CustomActionContentTypeId = "Text" ControlAssembly = "Text" ControlClass = "Text" ControlSrc = "Text" Description = "Text" GroupId = "Text" Id = "Text" ImageUrl = "Text" Location = "Text" RegistrationId = "Text" RegistrationType = "Text" RequireSiteAdministrator = "TRUE" | "FALSE" Rights = "Text" Sequence = "Integer" ShowInLists = "TRUE" | "FALSE" ShowInReadOnlyContentTypes = "TRUE" | "FALSE" ShowInSealedContentTypes = "TRUE" | "FALSE" Title = "Text"> </CustomAction>Twitter: @gvaroEmail: [email protected]: www.geoffvarosky.comCompany: www.grace-hunt.com
- 34. Anatomy of a Custom ActionId (optional)Specifies a unique identifier for custom action
- 35. May be a GUID or a unique term
- 36. Example:DeleteWebGroupID(optional)Identifies the unique group that this element is contained in
- 37. Example:SiteAdministrationTwitter: @gvaroEmail: [email protected]: www.geoffvarosky.comCompany: www.grace-hunt.com
- 38. Anatomy of a Custom ActionLocation (optional)Specifies the location for this custom action
- 39. Example:Microsoft.SharePoint.SiteSettingsRegistrationType(optional)Specifies the list, item content type, file type, or programmatic identifier that this action is associated with
- 40. Example: ListTwitter: @gvaroEmail: [email protected]: www.geoffvarosky.comCompany: www.grace-hunt.com
- 41. Anatomy of a Custom ActionRegistrationId(optional)Specifies the registration attachment for a per-item action
- 42. Example (List Identifier – Task List): 107 (http://snipurl.com/ntd5g)Title (required)Specifies the name of your action
- 43. Example: DeleteWebDescription (optional)Longer description for action which is shown as a tooltip or sub-description (where applicable) for the actionTwitter: @gvaroEmail: [email protected]: www.geoffvarosky.comCompany: www.grace-hunt.com
- 44. Anatomy of a Custom ActionSequence (optional)The order in which your action will appear.
- 45. If not specified, displayed in the order it is read by SharePoint by Feature and by order in element listing (XML).Twitter: @gvaroEmail: [email protected]: www.geoffvarosky.comCompany: www.grace-hunt.com
- 46. Anatomy of a Custom ActionPermissionsRequireSiteAdministrator (optional)
- 47. Boolean (True or False)
- 48. Cannot be used on ECB menu list items
- 49. Rights
- 50. Specify rights needed for this Custom Action to be visible
- 52. Possible Values http://snipurl.com/ntcz5Twitter: @gvaroEmail: [email protected]: www.geoffvarosky.comCompany: www.grace-hunt.com
- 53. Anatomy of a Custom ActionUrlAction Tokens~site
- 54. References the current SPWeb context
- 55. ~sitecollection
- 56. References the current SPSite context
- 57. {ItemId}
- 58. GUID of the item action is called from
- 59. {ItemUrl}
- 60. URL of the item the action is called fromTwitter: @gvaroEmail: [email protected]: www.geoffvarosky.comCompany: www.grace-hunt.com
- 61. Anatomy of a Custom ActionUrlAction Tokens{ListId}
- 62. GUID representation of the list
- 63. {SiteUrl}
- 64. References the URL of the SPWeb context the action is called from
- 65. {RecurrenceId}
- 66. Unsupported in context menus (http://snipurl.com/ntcjc)
- 67. Source URL
- 68. This token is not available, but there is a way to get it via JavaScript, which we will see in Demo #2
- 69. http://snipurl.com/d8zb6Twitter: @gvaroEmail: [email protected]: www.geoffvarosky.comCompany: www.grace-hunt.com
- 70. DemoCreating a Slightly More Complex Custom ActionView Demo: http://www.vimeo.com/9728320Twitter: @gvaroEmail: [email protected]: www.geoffvarosky.comCompany: www.grace-hunt.com
- 71. DemoHiding Custom ActionsView Demo: http://www.vimeo.com/9728353Twitter: @gvaroEmail: [email protected]: www.geoffvarosky.comCompany: www.grace-hunt.com
- 72. DemoCustom Action GroupsView Demo: http://www.vimeo.com/9759410Twitter: @gvaroEmail: [email protected]: www.geoffvarosky.comCompany: www.grace-hunt.com
- 73. ResourcesMy Bloghttp://www.geoffvarosky.comClick on SharePoint Saturday category on left side of pageGraceHunt.SharePointCodePlex Projectshttp://codeplex.com/GraceHuntJohn Holliday’s Custom Action ResourcesHiding Custom Actions, and a Utility to get all custom action identifiers http://snipurl.com/d8zeaTwitter: @gvaroEmail: [email protected]: www.geoffvarosky.comCompany: www.grace-hunt.com
- 74. ResourcesMSDNCustom Action Definitions http://snipurl.com/d8zi7Default Custom Action Locations and IDs http://snipurl.com/d8zkaHow to: Add Custom Actions to the User Interfacehttp://snipurl.com/d8zq2CustomAction Element http://snipurl.com/d9jd4CustomActionGroup Element http://snipurl.com/d9jfxHideCustomAction Elementhttp://snipurl.com/d9jhsTwitter: @gvaroEmail: [email protected]: www.geoffvarosky.comCompany: www.grace-hunt.com
- 75. ResourcesCustom Actions in SharePoint 2010Adding Custom Button to the SharePoint 2010 Ribbonhttp://snipurl.com/tz3vq by Jonathon Frost @ MSDNAdding Custom Actions to the List Item Menu in SharePoint 2010 Using SharePoint Designer 2010 http://snipurl.com/tr0t3 by Geoff VaroskyHow to Add a Tab to the Ribbon in SharePoint Foundation http://snipurl.com/tz3wi by Andrew May @ SP Dev Doc TeamTwitter: @gvaroEmail: [email protected]: www.geoffvarosky.comCompany: www.grace-hunt.com
- 76. Q&ATwitter: @gvaroEmail: [email protected]: www.geoffvarosky.comCompany: www.grace-hunt.com
- 77. About MeGeoff Varosky MCP, MCTSSenior Solutions Developer for Grace-Hunt, LLC.Company: http://www.grace-hunt.comBlog: http://www.geoffvarosky.comEmail: [email protected]: @gvaro
Editor's Notes
- #34: stsadm -o activatefeature -name SPS.HideCustomAction -url http://site.litwareinc.com