Skip to main content

 

Documentation & User Guides | FotoWare

Troubleshooting Widget Integrations

Problem

"App not registered" and kitten when opening /fotoweb/widgets/selection!

Cause

You are trying to use the widget in the legacy way (without any URL parameters (no access token)) when it is not enabled.

Problem

"App not registered" and kitten when opening the FotoWeb OAuth URL (/fotoweb/oauth2/authorize/...)

Cause

Your application is not registered, or you are using the wrong redirect URL in the authorization request.

Remedy

Register your app using the correct redirect URI and use that redirect URI in the request:
https://learn.fotoware.com/02_FotoWe...sing_OAuth_2.0

Tip

If your app is registered with only one redirect URI, then you don't need to explicitly specify it in the authorization request. Not specifying it eliminates the problem of using the wrong one.

Tip 2

The redirect URL must be exactly as registered: Same path, same protocol (HTTPS vs. HTTP. I hope you are using HTTPS...). Query string parameters and fragments are not allowed.

 

Problem

The FotoWeb OAuth URL (/fotoweb/oauth2/authorize/...) requires a client ID. What is the client ID?

Cause

Your application is not registered, so there is no client ID, yet.

Problem

My integration broke when I updated to FR12

Cause

Your integration is using the widget in the legacy way when it is not enabled.

Remedy

Either enable "Legacy selection widget" in the site settings, or update your integration to use the new (more secure) way: https://learn.fotoware.com/02_FotoWeb_8.0/Integrating_FotoWeb_with_third-party_systems/01_Using_Embeddable_Widgets

 

Problem

My integration still works after FR12 (with legacy enabled), but it looks ugly / I don't like it

Cause

We had to change the user experience to make it work with OAuth. Sorry, but it has to be done this way.

Remedy

Update your integration to use the new way. It will give you more freedom to determine the user experience for user authorization. See https://learn.fotoware.com/02_FotoWeb_8.0/Integrating_FotoWeb_with_third-party_systems/01_Using_Embeddable_Widgets. We will be happy to help you migrate!

 

Problem

Instead of the selection widget, I only see a blank white box

Cause 1

You are embedding the selection widget in an IFRAME in an app that uses HTTPS, but FotoWeb does not use HTTPS.

Remedy 1

Configure FotoWeb to use HTTPS and open the selection widget using a HTTPS URL.

Cause 2

You are opening the FotoWeb OAuth URL (/fotoweb/oauth2/authorize/...) in an IFRAME.

Remedy 2

You can only open the FotoWeb OAuth URL in a top-level browser window or tab. Either open it in the current window, or in a new browser tab or window and use local storage to get hold of the access token. See https://learn.fotoware.com/02_FotoWeb_8.0/Integrating_FotoWeb_with_third-party_systems/01_Using_Embeddable_Widgets/Using_the_widgets ("IFRAMEs" section)

 

Problem

Instead of the selection widget, I see a white box with a Log in to FotoWeb button

Cause

You are trying to use the widget in the legacy way (without any URL parameters (no access token))

Alternative remedy

If you intend to use the legacy way, then this is the way it works. The user has to "log in" by clicking the button. If you don't like it, then use the new way.