Please do consult the documentation.
You can create a subtheme based of ours using the theme generator built into the portal UI, you can then extend that theme using any of the standard drupal mechanisms to customise functionality further.
As I am sure you can appreciate, the nature of customisations like this is that no two requests are the same, so expecting step by step instructions is obviously unrealistic. It is possible to customise pretty much anything - however the amount of work involved in doing so can vary, and realistically sometimes it simply isn't worth the effort. e.g. adding additional fields to the create application form is easy. Customising the sign up process is definitely not.
I am afraid "enhanced ui/ux" means very little, so its pretty hard to comment on that - it would be entirely subjective. What they might regard as an improvement might be seen as counter-intuitive by someone else.
You cannot run the portal locally - you can only run it in APIC. You can export the customisations from one site to another, thats possible using the portaladmin CLI/API - but you should create those customisations in an APIC deployment.
Original Message:
Sent: Sun December 29, 2024 02:49 AM
From: ahmad taha
Subject: Customizing Developer Portal locally
The client has requested the following enhancements for the Developer Portal:
1. Theme Customization: The ability to customize the portal's theme to align with their existing brand guidelines, including the incorporation of their logo.
2. Enhanced UI/UX: A re-development of the portal to improve the user interface and user experience, making it more user-friendly and intuitive for developers.
3. Alternative Customization Approach: Given the limitations in accessing the Portal Admin User, I am exploring alternative approaches to customize the developer portal. This could involve customizing the portal on a developer's machine and then exporting the customized configuration for deployment by the client's administrators.
Regards
------------------------------
Ahmad Taha
Enterprise Architect | IBM | Coach | TOGAF
Original Message:
Sent: Thu December 26, 2024 12:50 PM
From: Chris Dudley
Subject: Customizing Developer Portal locally
That tutorial is specific to creating a completely private, locked down portal site, that's not a hugely common use case.
What are you trying to achieve?
There are tutorials on a variety of use cases in the docs - so make sure you're using the right version of the docs for the version of apic you're using.
Theme customizations aren't limited - but we don't help with them via IBM support cases. Customizations aren't limited the customer's responsibility, services can be enlisted (from ibm or others) should assistance be needed.
What is it you actually want to do?
------------------------------
Chris Dudley
Original Message:
Sent: Thu December 26, 2024 07:15 AM
From: ahmad taha
Subject: Customizing Developer Portal locally
If difficulties are encountered in starting the API Connect Developer Portal on a standalone Drupal server, are there alternative methods for customizing the API Connect Developer Portal theme? Or are theme customizations restricted to the options provided by IBM?
https://www.ibm.com/docs/en/api-connect/10.0.x?topic=tutorials-tutorial-creating-private-developer-portal-site
------------------------------
Ahmad Taha
Enterprise Architect | IBM | Coach | TOGAF
Original Message:
Sent: Thu December 19, 2024 02:38 AM
From: Chris Dudley
Subject: Customizing Developer Portal locally
I'm afraid this is not supported and won't work.
The portal only works with our pods in an apic deployment, there is no "run it locally" option, even for our team.
It's intrinsically linked to an api manager which you need in order to get content and login.
Just deploy an apic stack and use the portal within that.
------------------------------
Chris Dudley
Original Message:
Sent: Wed December 18, 2024 05:07 AM
From: ahmad taha
Subject: Customizing Developer Portal locally
I'm seeking guidance on running the IBM API Connect Developer Portal locally using Docker for the purpose of customizing the API Connect theme. This will allow me to test the customized theme within my own local testing environment.
Following the instructions from the provided documentation:
[Testing an API with the Local Test Environment - IBM Documentation]
Tutorial: Creating a private Developer Portal site - IBM Documentation
Here are the steps I've taken:
- Cloned the IBM API Connect Developer Portal Git repository from GitHub: [GitHub - ibm-apiconnect/devportal: IBM API Connect Developer Portal built on the Drupal CMS]
- Attempted to start the Docker Compose configuration to run the database and Drupal instance using
docker-compose up , and to create default portal profile using apim_profile folder using (docker build .)
However, I'm encountering an error during the build process (docker build .):
<response-element class="" ng-version="0.0.0-PLACEHOLDER"></response-element>
Question:
- Given that I have an IBM pull secret, what is the correct
cp.icr.io repository link to pull the required image?
By specifying the correct repository link, I can successfully build the image and proceed with my local testing.
Thank you for your assistance.
------------------------------
Ahmad Taha
Enterprise Architect | IBM | Coach | TOGAF
------------------------------