{ Community }
  • Academy
  • Docs
  • Developers
  • Resources
    • Community Articles
    • Apigee on GitHub
    • Code Samples
    • Videos & eBooks
    • Accelerator Methodology
  • Support
  • Ask a Question
  • Spaces
    • Product Announcements
    • General
    • Edge/API Management
    • Developer Portal (Drupal-based)
    • Developer Portal (Integrated)
    • API Design
    • APIM on Istio
    • Extensions
    • Business of APIs
    • Academy/Certification
    • Adapter for Envoy
    • Analytics
    • Events
    • Hybrid
    • Integration (AWS, PCF, Etc.)
    • Microgateway
    • Monetization
    • Private Cloud Deployment
    • 日本語コミュニティ
    • Insights
    • IoT Apigee Link
    • BaaS/Usergrid
    • BaaS Transition/Migration
    • Apigee-127
    • New Customers
    • Topics
    • Questions
    • Articles
    • Ideas
    • Articles
    • Ideas
    • Leaderboard
    • Badges
  • Log in
  • Sign up

Get answers, ideas, and support from the Apigee Community

  • Home /
  • Developer Portal (Drupal-based) /
avatar image
7

Developer Portal Quick Starter Guide  

  • Export to PDF
cesar created · Mar 27, 2015 at 04:52 PM · 8.3k Views · Dom Couldwell edited · Aug 10, 2016 at 03:48 PM

Here's a high level strategy I recommend on releasing the Developer Portal quickly with minimal effort.

Quick Starter Strategy

1) Leverage as much out of the box functionality as possible. Avoid creating custom modules or a custom theme which requires coding.

2) Customize the appearance and theme using the built in Drupal UI:

http://apigee.com/docs/developer-services/content/customize-appearance

3) Configure your App registration process:

http://apigee.com/docs/developer-services/content/configuring-api-products

4) Leverage Drupal CMS UI to create and customize, and layout the content:

http://apigee.com/docs/developer-services/content/add-and-edit-content

5) The preferred API documentation solution is to leverage SmartDocs. This requires creating a Swagger or WADL file. If time doesn't permit, the fall back option to manually create content (see step 4).

6) Redirect live site to your production domain: For example, Innotech wants the Pantheon Live environment at http://live-innotech.devportal.apigee.com to instead be: http://innotech.developer.com

Solution: To configure your own domain to point to your Apigee Dev Portal site, you will need to setup a CNAME in your DNS pointing the domain you want to edge.apigee.getpantheon.com. For example, the DNS setting for a fictitious company named Innotech would be:

developer.innotech.com. 3600 IN CNAME edge.apigee.getpantheon.com.

Note: It could take up to 48 hours for this DNS change to take effect for all client devices. You can then add this domain to your Pantheon dashboard, which can be found under the Domains / SSL tab. In most cases, you'll only need to configure DNS for the Live environment. If you need access to your Pantheon dashboard, please contact support with the email addresses you need added to your site. The instructions on the Pantheon dashboard will tell the customer to use CNAME edge.live.getpantheon.com, but this is incorrect. I have asked Pantheon to make a change to Apigee sites but they have not yet fixed this (as of Feb 2015) Customers should not use the Dev or Test environments for production use. For example, do not point developer.innotech.com to dev-innotech.devportal.apigee.com. Only paid customers can redirect their domain to their Dev Portal cloud site.

Visit https://pantheon.io/docs/articles/sites/domains/dns-records-for-directing-your-domain-to-your-pantheon-site/ for more information.

Useful Documentation Links

What is a developer portal:

http://apigee.com/docs/developer-services/content/what-developer-portal

Developer Portal FAQ:

http://apigee.com/docs/developer-services/content/developer-portal-faq

Communicating between the portal and Edge:

http://apigee.com/docs/developer-services/content/communicating-between-developer-services-portal-and-edge

Working with Pantheon:

http://apigee.com/docs/developer-services/content/working-pantheon

Add and edit content:

http://apigee.com/docs/developer-services/content/add-and-edit-content

SmartDocs is the documentation feature. It can consume Swagger as well as WADL:

http://apigee.com/docs/developer-services/content/using-smartdocs-document-apis

Apigee Edge APIs

Out the box, the Developer Portal uses the Developer and Developer App Apigee Edge APIs. Apigee Edge APIs (non-monetization): http://apigee.com/docs/api/apps-developer.

Edge Monetization APIs (used by Dev Portal): http://apigee.com/docs/developer-services/content/what-api-product

Complex Theming/Branding

Customizing the theme by creating a sub theme:

http://apigee.com/docs/developer-services/content/customizing-theme

http://DrupalizeMe.net has some great training tutorials.

Here's a great video tutorial on theming in Drupal 7:

Example Developer Portals using a sub theme:

http://developer.payeezy.com/

http://developer.gracenote.com

https://developer.gracenote.com/ja?language=ja

https://apideveloper.vantiv.com/

https://developer.inmarsat.com/

https://developer.ft.com/

https://developer.openplatform.co/

https://developer.kp.org

http://live-ecollege.devportal.apigee.com

https://developer.sears.com

https://developer.walgreens.com

https://developers.digitalriver.com

https://developer.equinix.com/

thub.nodes.view.add-new-comment
Portal - Drupalaccelerator methodology
Add comment Show 3
10 |5000 characters needed characters left characters exceeded
▼
  • Viewable by all users
  • Viewable by Apigeeks only
  • Viewable by the original poster
  • Viewable by moderators
  • Viewable by moderators and the original poster
  • Advanced visibility
Viewable by all users
avatar image santanu4g · Sep 05, 2015 at 03:08 AM 0
Link

Very helpful information. Quick question: How do you add Developer & App specific analytics from Edge to show up?

avatar image Anil Sagar @ Google ♦♦ santanu4g   · Sep 05, 2015 at 08:02 AM 0
Link

@santanu4g , Please post it as a new question so that it will be helpful for others too.

avatar image davissean ♦   · Mar 29, 2018 at 01:50 AM 0
Link

Another great resource are the four minute developer videos - here. Thanks for these @Anil Sagar!

Article

Contributors

avatar image avatar image avatar image

Follow this article

18 People are following this .

avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image

Navigation

Developer Portal Quick Starter Guide

Related Articles

Content Access Control on Developer Portal using Content Access

SmartDocs role based access control

Customising Look & Feel of Apigee Developer Portal Home Page

Edge Private Cloud on a closed network developer portal call to pull a jquery library off the net fails

Manually upgrading a production Dev Portal environment from a stage environment

Tutorial: allowing sign-in to the Apigee Edge (Drupal-based) Developer Portal using OpenID Connect

Advantage Drupal with your Apigee Developer Portal

Installing Developer Portal Multi Datacenter Version:4.17.xx and higher

Apigee Developer Portal - Go Live Check List

Documenting SOAP APIs on Devportal using the WSDL Docs Module - New Release

  • Products
    • Edge - APIs
    • Insights - Big Data
    • Plans
  • Developers
    • Overview
    • Documentation
  • Resources
    • Overview
    • Blog
    • Apigee Institute
    • Academy
    • Documentation
  • Company
    • Overview
    • Press
    • Customers
    • Partners
    • Team
    • Events
    • Careers
    • Contact Us
  • Support
    • Support Overview
    • Documentation
    • Status
    • Edge Support Portal
    • Privacy Policy
    • Terms & Conditions
© 2021 Apigee Corp. All rights reserved. - Apigee Community Terms of Use - Powered by AnswerHub
  • Anonymous
  • Sign in
  • Create
  • Ask a question
  • Create an article
  • Post an idea
  • Create an article
  • Post an idea
  • Spaces
  • Product Announcements
  • General
  • Edge/API Management
  • Developer Portal (Drupal-based)
  • Developer Portal (Integrated)
  • API Design
  • APIM on Istio
  • Extensions
  • Business of APIs
  • Academy/Certification
  • Adapter for Envoy
  • Analytics
  • Events
  • Hybrid
  • Integration (AWS, PCF, Etc.)
  • Microgateway
  • Monetization
  • Private Cloud Deployment
  • 日本語コミュニティ
  • Insights
  • IoT Apigee Link
  • BaaS/Usergrid
  • BaaS Transition/Migration
  • Apigee-127
  • New Customers
  • Explore
  • Topics
  • Questions
  • Articles
  • Ideas
  • Articles
  • Ideas
  • Badges