/**
 * Copyright (c) 2012-2014 Piotr Sipika; see the AUTHORS file for more.
 * Copyright (C) 2023,2025 Ingo Brückl
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software Foundation,
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
 * 
 * See the COPYRIGHT file for more information.
 */

#include "location.h"
#include "forecast.h"
#include "yahooutil.h"
#include "weatherwidget.h"
#include "logutil.h"

/* Using pthreads instead of glib's due to cancellability and API stability */
#include <pthread.h> 

#include <glib/gi18n.h>
#include <gdk/gdkkeysyms.h>
#include <stdio.h>
#include <stdlib.h>
#include <errno.h>
#include <string.h>

#include "gtk-compat.h"

/* Private structure, property and signal definitions. */
#define GTK_WEATHER_GET_PRIVATE(obj) (G_TYPE_INSTANCE_GET_PRIVATE ((obj), \
                                      GTK_WEATHER_TYPE, GtkWeatherPrivate))

/* This will exit the app gracefully... */
#ifdef DEBUG
#define LOG_ERRNO(e, msg) \
  do { errno = e; logUtil(LXW_ERROR, "%s: %s", msg, strerror(errno)); gtk_main_quit(); } while (0)
#else
#define LOG_ERRNO(e, msg) gtk_main_quit()
#endif

#define GTK_WEATHER_NAME "GtkWeather"
#define GTK_WEATHER_NOT_AVAILABLE_LABEL _("[N/A]")

typedef struct _GtkWeatherPrivate     GtkWeatherPrivate;
typedef struct _LocationThreadData    LocationThreadData;
typedef struct _ForecastThreadData    ForecastThreadData;
typedef struct _PopupMenuData         PopupMenuData;
typedef struct _PreferencesDialogData PreferencesDialogData;

enum
{
  CITY_COLUMN = 0,
  STATE_COLUMN,
  COUNTRY_COLUMN,
  MAX_COLUMNS
};

#ifdef USE_STANDALONE
struct _PopupMenuData
{
  GtkWidget * menu;
  GtkWidget * refresh_item;
  GtkWidget * preferences_item;
  GtkWidget * quit_item;
};
#endif

struct _PreferencesDialogData
{
  gboolean shown;
  GtkWidget * dialog;
  GtkWidget * location_label;
  GtkWidget * location_button;
  GtkWidget * alias_entry;
  GtkWidget * c_button;
  GtkWidget * f_button;
  GtkWidget * manual_button;
  GtkWidget * auto_button;
  GtkWidget * auto_spin_button;
  GtkWidget * provider_button;
};

struct _LocationThreadData
{
  pthread_t * tid;
  gchar     * location;
  GtkProgressBar * progress_bar;
  GtkWidget * progress_dialog;
};

struct _ForecastThreadData
{
  gint timerid;
};

struct _GtkWeatherPrivate
{
  /* Main Widget Box layout */
  GtkWidget * hbox;
  GtkWidget * image;
  GtkWidget * label;

  /* Menus and dialogs */
#ifdef USE_STANDALONE
  PopupMenuData menu_data;
#endif
  PreferencesDialogData preferences_data;
  GtkWidget * conditions_dialog;

  /* Internal data */
  provider_callback_info * provider;
  ProviderInfo * provider_instance;
  LocationInfo * previous_location;
  LocationInfo * location;
  ForecastInfo * forecast;

  /* Data for location and forecast retrieval threads */
  LocationThreadData location_data;
  ForecastThreadData forecast_data;
};

enum
{
  LOCATION_CHANGED_SIGNAL,
  FORECAST_CHANGED_SIGNAL,
  LAST_SIGNAL
};

enum 
{
  PROP_0,
  PROP_LOCATION,
  PROP_FORECAST
};

static guint gtk_weather_signals[LAST_SIGNAL] = {0};

/* Function declarations. */
static void gtk_weather_class_init    (GtkWeatherClass * klass);
static void gtk_weather_init          (GtkWeather * weather);
static void gtk_weather_size_allocate (GtkWidget * widget, GtkAllocation * allocation);

static void gtk_weather_destroy       (GObject * object);

static void gtk_weather_set_property (GObject * object, guint prop_id, 
                                      const GValue * value, GParamSpec * param_spec);
static void gtk_weather_get_property (GObject * object, guint prop_id, 
                                      GValue * value, GParamSpec * param_spec);

static void gtk_weather_set_location (GtkWeather * weather, gpointer location);
static void gtk_weather_set_forecast (GtkWeather * weather, ForecastInfo * forecast);

static gboolean gtk_weather_button_pressed  (GtkWidget * widget, GdkEventButton * event);
static gboolean gtk_weather_key_pressed     (GtkWidget * widget, GdkEventKey * event, gpointer data);
static gboolean gtk_weather_change_location (GtkWidget * widget, GdkEventButton * event);

static void gtk_weather_auto_update_toggled (GtkWidget * widget);

#ifdef USE_STANDALONE
static void gtk_weather_create_popup_menu            (GtkWeather * weather);
#endif
static void gtk_weather_set_window_icon              (GtkWindow * window, gchar * icon_id);
static void gtk_weather_show_location_progress_bar   (GtkWeather * weather);
static void gtk_weather_show_location_list           (GtkWeather * weather, GList * list);
static void gtk_weather_update_preferences_dialog    (GtkWeather * weather);

static void gtk_weather_get_forecast (GtkWeather * weather);

static void gtk_weather_run_error_dialog (GtkWindow * parent, gchar * error_msg);

static gboolean gtk_weather_update_location_progress_bar (gpointer data);

static void * gtk_weather_get_location_threadfunc  (void * arg);
static gboolean gtk_weather_get_forecast_timerfunc (gpointer data);


/* Function definitions. */

/**
 * Provides the type definition for this widget.
 *
 * @return The type identifier for this widget.
 */
GType
gtk_weather_get_type(void)
{
  /* 
   * Normally, the variable below is declared static and initialized to 0.
   * However, when dealing with lxpanel, the type remains registered, 
   * while this widget class is removed from scope. 
   * This means that the variable below goes out of scope, BUT the type
   * remains registered with GTK.
   * Hence, g_type_from_name...
   */
  GType gtk_weather_type = g_type_from_name(GTK_WEATHER_NAME);

  LXW_LOG(LXW_DEBUG, "GtkWeather::get_type(): %lu", (gulong)gtk_weather_type);

  if (!gtk_weather_type)
    {
      static const GTypeInfo gtk_weather_info = 
        {
          sizeof(GtkWeatherClass),
          NULL,
          NULL,
          (GClassInitFunc)gtk_weather_class_init,
          NULL,
          NULL,
          sizeof(GtkWeather),
          0,
          (GInstanceInitFunc)gtk_weather_init,
          NULL
        };

      gtk_weather_type = g_type_register_static(GTK_TYPE_EVENT_BOX, 
                                                GTK_WEATHER_NAME,
                                                &gtk_weather_info,
                                                0);

    }

  return gtk_weather_type;
}

/**
 * Returns a new instance of this widget.
 *
 * @param standalone Whether or not this widget is being created from an 
 *                   application/plugin (FALSE) or if this widget IS the
 *                   application (TRUE). 
 *
 * @return A new instance of this widget type.
 */
GtkWeather *
gtk_weather_new(void)
{
  GObject * object = g_object_new(gtk_weather_get_type(), NULL);

  return GTK_WEATHER(object);
}

/**
 * Initializes this widget's class internals.
 *
 * @param klass Pointer to this widget's class.
 */
static void
gtk_weather_class_init(GtkWeatherClass * klass)
{
  GObjectClass * gobject_class = (GObjectClass *)klass;
  GtkWidgetClass * widget_class = (GtkWidgetClass *)klass;

  gobject_class->set_property = gtk_weather_set_property;
  gobject_class->get_property = gtk_weather_get_property;
  gobject_class->finalize     = gtk_weather_destroy;

  //widget_class->expose_event = gtk_weather_expose;
  //widget_class->size_request = gtk_weather_size_request;
  widget_class->size_allocate      = gtk_weather_size_allocate;
  widget_class->button_press_event = gtk_weather_button_pressed;
  
  g_type_class_add_private(klass, sizeof(GtkWeatherPrivate));

  g_object_class_install_property(gobject_class, PROP_LOCATION,
                                  g_param_spec_pointer("location",
                                                       "Current Location",
                                                       "Current Location",
                                                       G_PARAM_READWRITE));

  g_object_class_install_property(gobject_class, PROP_FORECAST,
                                  g_param_spec_pointer("forecast",
                                                       "Current Conditions",
                                                       "Current conditions and forecast",
                                                       G_PARAM_READWRITE));

  gtk_weather_signals[LOCATION_CHANGED_SIGNAL] = g_signal_new("location-changed",
                                                              G_TYPE_FROM_CLASS(klass),
                                                              G_SIGNAL_RUN_FIRST | G_SIGNAL_ACTION,
                                                              G_STRUCT_OFFSET(GtkWeatherClass, location_changed),
                                                              NULL,
                                                              NULL,
                                                              g_cclosure_marshal_VOID__POINTER,
                                                              G_TYPE_NONE,
                                                              1,
                                                              G_TYPE_POINTER);

  gtk_weather_signals[FORECAST_CHANGED_SIGNAL] = g_signal_new("forecast-changed",
                                                              G_TYPE_FROM_CLASS(klass),
                                                              G_SIGNAL_RUN_FIRST | G_SIGNAL_ACTION,
                                                              G_STRUCT_OFFSET(GtkWeatherClass, forecast_changed),
                                                              NULL,
                                                              NULL,
                                                              g_cclosure_marshal_VOID__POINTER,
                                                              G_TYPE_NONE,
                                                              1,
                                                              G_TYPE_POINTER);
 
}

/**
 * Initializes this widget's instance.
 *
 * @param weather Pointer to this widget's instance.
 */
static void
gtk_weather_init(GtkWeather * weather)
{
  LXW_LOG(LXW_DEBUG, "GtkWeather::init()");

  GtkWeatherPrivate * priv = GTK_WEATHER_GET_PRIVATE(weather);

  /* Box layout internals */
  priv->hbox = gtk_hbox_new(FALSE, 1);

  priv->image = gtk_image_new_from_stock(GTK_STOCK_DIALOG_ERROR, GTK_ICON_SIZE_BUTTON);

  priv->label = gtk_label_new(GTK_WEATHER_NOT_AVAILABLE_LABEL);

  gtk_box_pack_start(GTK_BOX(priv->hbox),
                     priv->image,
                     FALSE,
                     FALSE,
                     2);

  gtk_box_pack_start(GTK_BOX(priv->hbox),
                     priv->label,
                     FALSE,
                     FALSE,
                     0);

  gtk_container_add(GTK_CONTAINER(weather), priv->hbox);

  gtk_container_set_border_width(GTK_CONTAINER(weather), 2);

  /* Popup menu */
#ifdef USE_STANDALONE
  gtk_weather_create_popup_menu(weather);
#endif

  priv->forecast_data.timerid = 0;

  /* Adjust size of label and icon inside */
  gtk_weather_render(weather);
}

/**
 * Destroys the weather widget object
 *
 * @param object Pointer to this widget's instance cast as a GObject
 */
static void
gtk_weather_destroy(GObject * object)
{
  LXW_LOG(LXW_DEBUG, "GtkWeather::destroy()");

  g_return_if_fail(object != NULL);
  g_return_if_fail(IS_GTK_WEATHER(object));

  GtkWeather * weather = GTK_WEATHER(object);

  GtkWeatherPrivate * priv = GTK_WEATHER_GET_PRIVATE(weather);

  if (priv->forecast_data.timerid > 0)
    {
      g_source_remove(priv->forecast_data.timerid);
      priv->forecast_data.timerid = 0;
    }

  if (priv->provider)
    priv->provider->freeProvider(priv->provider_instance);

  /* Need to free location and forecast. */
  freeLocation(priv->previous_location);
  freeLocation(priv->location);
  freeForecast(priv->forecast);

  priv->previous_location = NULL;
  priv->location = NULL;
  priv->forecast = NULL;
}

/**
 * Makes the requested allocation happen for this widget.
 *
 * @param widget     Pointer to the instance of this widget.
 * @param allocation Pointer to the allocation being done.
 */
static void
gtk_weather_size_allocate(GtkWidget * widget, GtkAllocation * allocation)
{
  /*  g_return_if_fail(widget != NULL || allocation != NULL);
      g_return_if_fail(IS_GTK_WEATHER(widget));*/
  if (!widget || !allocation || !IS_GTK_WEATHER(widget))
    {
      return;
    }

  GtkWeatherPrivate * priv = GTK_WEATHER_GET_PRIVATE(GTK_WEATHER(widget));

  LXW_LOG(LXW_DEBUG, "GtkWeather::size_allocate(%d): x: %d, y: %d, %dx%d (x: %d, y: %d, %dx%d)", 
          gtk_widget_get_has_window(widget),
          allocation->x, allocation->y, allocation->width, allocation->height,
          widget->allocation.x, widget->allocation.y, 
          widget->allocation.width, widget->allocation.height);

  /* check new allocation against previous one (height), 
     if they don't match, make a new icon...
     this is done inside gtk_weather_render() function
   */

  gtk_widget_set_allocation(widget, allocation);

  gboolean weather_has_window = gtk_widget_get_has_window(widget);

  if (gtk_widget_get_realized(widget) && weather_has_window)
    {
      gdk_window_move_resize(gtk_widget_get_window(widget),
                             allocation->x, 
                             allocation->y, 
                             allocation->width, 
                             allocation->height);
    }
   
  GtkAllocation box_allocation;

  /* we know the private hbox doesn't have a window */
  box_allocation.x = 0;
  box_allocation.y = 0;

  /* but in case we don't, either, let's make sure 
   * the box appears correctly...
   */
  if (!weather_has_window)
    {
      box_allocation.x = allocation->x;
      box_allocation.y = allocation->y;
    }

  box_allocation.height = allocation->height;
  box_allocation.width = allocation->width;

  gtk_widget_size_allocate(GTK_WIDGET(priv->hbox), &box_allocation);
}

/**
 * Helper function to update the widget based on internal change.
 *
 * @param weather Pointer to the instance of this widget.
 */
void
gtk_weather_render(GtkWeather * weather)
{
  GtkWeatherPrivate * priv = GTK_WEATHER_GET_PRIVATE(weather);
 
  LXW_LOG(LXW_DEBUG, "GtkWeather::render(): location: %p, forecast: %p",
          priv->location, priv->forecast);
 
  if (priv->location && priv->forecast)
    {
      /*LocationInfo * location = (LocationInfo *)priv->location;*/
      ForecastInfo * forecast = priv->forecast;

      GtkRequisition req;

      gtk_widget_size_request(GTK_WIDGET(priv->hbox), &req);

      /* req will hold valid data for painted widget, so disregard if we're
       * running in a single app 
       */
      if (req.height)
        {          
          /* set this image to the one in the forecast at correct scale */
          GdkPixbuf * forecast_pixbuf = gdk_pixbuf_scale_simple(forecast->pImage_,
                                                                req.height * forecast->fAspectRatio,
                                                                req.height,
                                                                GDK_INTERP_BILINEAR);
          
          gtk_image_set_from_pixbuf(GTK_IMAGE(priv->image), forecast_pixbuf);

          if (G_IS_OBJECT(forecast_pixbuf))
            {
              g_object_unref(forecast_pixbuf);
            }

        }

      /* update the label with proper temperature */
      gchar * temperature = g_strdup_printf("%d \302\260%s", 
                                            forecast->iTemperature_,
                                            forecast->units_.pcTemperature_);

      weather_set_label_text(GTK_WIDGET(weather), priv->label, temperature);

      //gtk_widget_show_all(priv->hbox);

      g_free(temperature);
    }
  else
    {
      /* N/A */
      if (priv->location)
        {
          gtk_image_set_from_stock(GTK_IMAGE(priv->image), 
                                   GTK_STOCK_DIALOG_WARNING, 
                                   GTK_ICON_SIZE_BUTTON);
        }
      else
        {
          gtk_image_set_from_stock(GTK_IMAGE(priv->image), 
                                   GTK_STOCK_DIALOG_ERROR, 
                                   GTK_ICON_SIZE_BUTTON);
        }

      weather_set_label_text(GTK_WIDGET(weather), priv->label,
                             GTK_WEATHER_NOT_AVAILABLE_LABEL);
    }

  /* update tooltip with proper data... */
  gchar * tooltip_text = gtk_weather_get_tooltip_text(weather);

  gtk_widget_set_tooltip_text(GTK_WIDGET(weather), tooltip_text);

  g_free(tooltip_text);
}

/* Property access functions */
/**
 * Sets the specified property.
 *
 * @param object     Pointer to the GObject instance of this widget.
 * @param prop_id    Property Id of the property to set.
 * @param value      Pointer to the GValue containing actual value to use.
 * @param param_spec Pointer to GParamSpec structure for this property.
 */
static void
gtk_weather_set_property(GObject * object,
                         guint prop_id,
                         const GValue * value,
                         GParamSpec * param_spec)
{
  GtkWeather * weather = GTK_WEATHER(object);

  GtkWeatherPrivate * priv = GTK_WEATHER_GET_PRIVATE(weather);

  LXW_LOG(LXW_DEBUG, "GtkWeather::set_property(%u - %s)", prop_id,
          ((prop_id == PROP_LOCATION)?"location":
           (prop_id == PROP_FORECAST)?"forecast":"???"));

  switch (prop_id)
    {
    case PROP_LOCATION:
      gtk_weather_set_location(weather, g_value_get_pointer(value));

      /* Set previous location, to save it. */
      copyLocation(&priv->previous_location, priv->location);

      /* The function starts timer if enabled, otherwise runs a single call. */
      gtk_weather_get_forecast(weather);

      break;

    case PROP_FORECAST:
      gtk_weather_set_forecast(weather, g_value_get_pointer(value));
      break;

    default:
      G_OBJECT_WARN_INVALID_PROPERTY_ID(object, prop_id, param_spec);
      break;
    }

}

/**
 * Gets the specified property.
 *
 * @param object     Pointer to the GObject instance of this widget.
 * @param prop_id    Property Id of the property to get.
 * @param value      Pointer to the GValue to set with actual value.
 * @param param_spec Pointer to GParamSpec structure for this property.
 */
static void
gtk_weather_get_property(GObject * object, 
                         guint prop_id, 
                         GValue * value, 
                         GParamSpec * param_spec)
{
  GtkWeather * weather = GTK_WEATHER(object);
  GtkWeatherPrivate * priv = GTK_WEATHER_GET_PRIVATE(weather);

  switch (prop_id)
    {
    case PROP_LOCATION:
      g_value_set_pointer(value, priv->location);
      break;

    case PROP_FORECAST:
      g_value_set_pointer(value, priv->forecast);
      break;

    default:
      G_OBJECT_WARN_INVALID_PROPERTY_ID(object, prop_id, param_spec);
      break;
    }

}

/**
 * Sets the location property pointer for this widget.
 *
 * @param weather  Pointer to the instance of this widget.
 * @param location Location to use.
 *
 */
static void
gtk_weather_set_location(GtkWeather * weather, gpointer location)
{
  GtkWeatherPrivate * priv = GTK_WEATHER_GET_PRIVATE(weather);

  LXW_LOG(LXW_DEBUG, "GtkWeather::set_location(): current: %p, new: %p",
          priv->location, location);

#ifdef DEBUG
  printLocation(priv->location);
  printLocation(location);
#endif

  if (location)
    {
      copyLocation(&priv->location, location);

      /* reset forecast */
      gtk_weather_set_forecast(weather, NULL);

      /* weather is rendered inside */
    }
  else
    {
      freeLocation(priv->location);

      priv->location = NULL;

      gtk_weather_render(weather);
    }

  /* Emit location-changed event */
  g_signal_emit_by_name(weather, "location-changed", location);
}

/**
 * Sets the forecast property pointer for this widget.
 *
 * @param weather  Pointer to the instance of this widget.
 * @param forecast Forecast to use.
 *
 */
static void
gtk_weather_set_forecast(GtkWeather * weather, ForecastInfo * forecast)
{
  GtkWeatherPrivate * priv = GTK_WEATHER_GET_PRIVATE(weather);

  LXW_LOG(LXW_DEBUG, "GtkWeather::set_forecast(): current: %p, new: %p",
          priv->forecast, forecast);

#ifdef DEBUG
  printForecast(priv->forecast);
  printForecast(forecast);
#endif

  if (priv->forecast && priv->forecast != forecast)
    {
      freeForecast(priv->forecast);

      priv->forecast = forecast;
    }

  gtk_weather_render(weather);

  /* Emit forecast-changed event */
  g_signal_emit_by_name(weather, "forecast-changed", forecast);
}

provider_callback_info * gtk_weather_get_provider(GtkWeather * weather)
{
  GtkWeatherPrivate * priv = GTK_WEATHER_GET_PRIVATE(weather);

  return priv->provider;
}

int gtk_weather_set_provider(GtkWeather * weather, provider_callback_info * provider)
{
  GtkWeatherPrivate * priv = GTK_WEATHER_GET_PRIVATE(weather);
  ProviderInfo * instance = NULL;

  if (provider)
    instance = provider->initProvider();

  if (instance == NULL) /* failed to init */
    return 0;

  if (priv->provider)
    priv->provider->freeProvider(priv->provider_instance);

  priv->provider = provider;
  priv->provider_instance = instance;
  return 1;
}


/* Action callbacks (button/cursor/key) */
/**
 * Handles the button-pressed event.
 *
 * @param widget Pointer to the instance on which the event occurred.
 * @param event  Pointer to the event structure with details.
 *
 * @return TRUE if the event should not be propagated further, FALSE otherwise.
 */
static gboolean
gtk_weather_button_pressed(GtkWidget * widget, GdkEventButton * event)
{
  LXW_LOG(LXW_DEBUG, "GtkWeather::button_pressed(): Button: %d, type: %d", 
          event->button, event->type);

  GtkWeather * weather = GTK_WEATHER(widget);
  GtkWeatherPrivate * priv = GTK_WEATHER_GET_PRIVATE(weather);

#ifdef USE_STANDALONE
  /* If right-clicked, show popup */
  if (event->button == 3 && (event->type == GDK_BUTTON_PRESS))
    {
      gtk_weather_run_popup_menu(weather);

      return TRUE;
    }
#endif
  if (event->button == 1 && (event->type == GDK_BUTTON_PRESS))
    {
      if (priv->conditions_dialog)
        gtk_dialog_response(GTK_DIALOG(priv->conditions_dialog), GTK_RESPONSE_ACCEPT);
      else
        gtk_weather_run_conditions_dialog(weather);

      return TRUE;
    }

  return FALSE;
}

/**
 * Handles the toggled event for auto/manual radio buttons
 * 
 * @param widget Poitner to the instance of this widget
 */
static void 
gtk_weather_auto_update_toggled(GtkWidget * widget)
{
  LXW_LOG(LXW_DEBUG, "GtkWeather::auto_update_toggled()");

  GtkWeatherPrivate * priv = GTK_WEATHER_GET_PRIVATE(GTK_WEATHER(widget));

  LocationInfo * location = priv->location;

  if (gtk_toggle_button_get_active(GTK_TOGGLE_BUTTON(priv->preferences_data.auto_button)) &&
      priv->location)
    {
      gtk_toggle_button_set_active(GTK_TOGGLE_BUTTON(priv->preferences_data.manual_button), FALSE);
      gtk_widget_set_sensitive(GTK_WIDGET(priv->preferences_data.auto_spin_button), TRUE);
      gtk_spin_button_set_value(GTK_SPIN_BUTTON(priv->preferences_data.auto_spin_button), 
                                (gdouble)location->uiInterval_);
    }
  else
    {
      gtk_widget_set_sensitive(GTK_WIDGET(priv->preferences_data.auto_spin_button), FALSE);
    }
  
}

/**
 * Handles the button-pressed event for the location set/change button.
 *
 * @param widget Pointer to the instance of this widget.
 * @param event  Pointer to the event structure with details.
 *
 * @return TRUE if the event should not be propagated further, FALSE otherwise.
 */
static gboolean
gtk_weather_change_location(GtkWidget * widget, GdkEventButton * event)
{
  LXW_LOG(LXW_DEBUG, "GtkWeather::change_location");

  /* disable compilation warning */
  (void)event;

  GtkWeatherPrivate * priv = GTK_WEATHER_GET_PRIVATE(GTK_WEATHER(widget));

  GtkWidget * dialog = gtk_dialog_new_with_buttons(_("Enter New Location"),
                                                   GTK_WINDOW(priv->preferences_data.dialog),
                                                   GTK_DIALOG_MODAL | GTK_DIALOG_DESTROY_WITH_PARENT,
                                                   GTK_STOCK_OK, GTK_RESPONSE_ACCEPT,
                                                   GTK_STOCK_CANCEL, GTK_RESPONSE_REJECT,
                                                   NULL);

  /* Set dialog window icon */
  gtk_weather_set_window_icon(GTK_WINDOW(dialog), "gtk-properties");
  
  gtk_window_set_resizable(GTK_WINDOW(dialog), FALSE);

  gtk_dialog_set_default_response(GTK_DIALOG(dialog), GTK_RESPONSE_ACCEPT);

  GtkWidget * location_label = gtk_label_new_with_mnemonic(_("_New Location:"));

  GtkWidget * location_entry = gtk_entry_new();

  g_signal_connect(G_OBJECT(location_entry),
                   "key-press-event",
                   G_CALLBACK(gtk_weather_key_pressed),
                   (gpointer)dialog);

  GtkWidget * image = gtk_image_new_from_stock(GTK_STOCK_DIALOG_INFO, GTK_ICON_SIZE_DIALOG);

  GtkWidget * description_label = gtk_label_new(_("Enter the:\n- city, or\n- city and state/country, or\n- postal code\nfor which to retrieve the weather forecast."));

  gtk_label_set_justify(GTK_LABEL(description_label), GTK_JUSTIFY_LEFT);

  GtkWidget * entry_hbox = gtk_hbox_new(FALSE, 10);

  gtk_box_pack_start(GTK_BOX(entry_hbox), location_label, FALSE, FALSE, 5);
  gtk_box_pack_end(GTK_BOX(entry_hbox), location_entry, FALSE, FALSE, 5);

  GtkWidget * entry_vbox = gtk_vbox_new(FALSE, 10);

  gtk_box_pack_start(GTK_BOX(entry_vbox), description_label, FALSE, FALSE, 5);
  gtk_box_pack_start(GTK_BOX(entry_vbox), entry_hbox, FALSE, FALSE, 5);

  GtkWidget * label_hbox = gtk_hbox_new(FALSE, 10);

  gtk_box_pack_start(GTK_BOX(label_hbox), image, FALSE, FALSE, 5);
  gtk_box_pack_start(GTK_BOX(label_hbox), entry_vbox, FALSE, FALSE, 5);

  gtk_box_pack_start(GTK_BOX(gtk_dialog_get_content_area(GTK_DIALOG(dialog))), label_hbox, TRUE, FALSE, 10);

  gtk_widget_show_all(dialog);

  gint response = GTK_RESPONSE_NONE;

  do 
    {
      response = gtk_dialog_run(GTK_DIALOG(dialog));

      /* handle ACCEPT/OK response to process new location */
      switch(response)
        {
        case GTK_RESPONSE_ACCEPT:
          /* location must be entered... */
          if (gtk_entry_get_text_length(GTK_ENTRY(location_entry)) == 0)
            {
              gtk_weather_run_error_dialog(GTK_WINDOW(dialog), 
                                           _("You must specify a location."));

              break;
            }

          gchar * new_location = g_strdup(gtk_entry_get_text(GTK_ENTRY(location_entry)));
            
          /* start thread here, let the progress bar do its own magic */
          pthread_t tid;
          pthread_attr_t tattr;
            
          int ret = pthread_attr_init(&tattr);
            
          if (ret != 0)
            {
              LOG_ERRNO(ret, "pthread_attr_init");
            }

          priv->location_data.location = new_location;
          ret = pthread_create(&tid, &tattr, &gtk_weather_get_location_threadfunc, priv);

          if (ret != 0)
            {
              LOG_ERRNO(ret, "pthread_create");
            }

          ret = pthread_attr_destroy(&tattr);
      
          if (ret != 0)
            {
              LOG_ERRNO(ret, "pthread_attr_destroy");
            }
      
          priv->location_data.tid = &tid;

          /* show progress bar and lookup selected location */
          gtk_weather_show_location_progress_bar(GTK_WEATHER(widget));

          void * result = NULL;
      
          ret = pthread_join(tid, &result);
      
          if (ret != 0)
            {
              LOG_ERRNO(ret, "pthread_join");
            }

          gchar * error_msg = g_strdup_printf(_("Location '%s' not found!"), new_location);
      
          if (result && result != PTHREAD_CANCELED)
            {
              GList * list = (GList *)result;
          
              guint length = g_list_length(list);

              LXW_LOG(LXW_DEBUG, "Thread returned list of length %u", length);

              if (length > 0)
                {
                  gtk_weather_show_location_list(GTK_WEATHER(widget), list);
                }
              else
                {
                  gtk_weather_run_error_dialog(GTK_WINDOW(dialog), error_msg);
                }
          
              /* Free list */
              g_list_free_full(list, (GDestroyNotify)freeLocation);
          
              /* Repaint preferences dialog */
              gtk_weather_update_preferences_dialog(GTK_WEATHER(widget));
            }
          else if (result == PTHREAD_CANCELED)
            {
              /* nothing, user canceled search... */
            }
          else
            {
              gtk_weather_run_error_dialog(GTK_WINDOW(dialog), error_msg);
            }
      
          g_free(error_msg);

          g_free(new_location);

          break;

        default:
          LXW_LOG(LXW_DEBUG, "\tdefault: %d", response);

          break;
        }
        
    } while ( (response == GTK_RESPONSE_ACCEPT) &&
              (gtk_entry_get_text_length(GTK_ENTRY(location_entry)) == 0) );

  if (GTK_IS_WIDGET(dialog))
    {
      gtk_widget_destroy(dialog);
    }

  priv->location_data.tid = 0;
  priv->location_data.location = NULL;
     
  dialog = NULL;

  return TRUE;
}

/**
 * Handles the key-pressed event.
 *
 * @param widget Pointer to the instance on which the event occurred.
 * @param event  Pointer to the event structure with details.
 * @param data   Pointer to user-data.
 *
 * @return TRUE if the event should not be propagated further, FALSE otherwise.
 */
static gboolean
gtk_weather_key_pressed(GtkWidget * widget, GdkEventKey * event, gpointer data)
{
  LXW_LOG(LXW_DEBUG, "GtkWeather::key_pressed");

  if (GTK_IS_ENTRY(widget))
    {
      /* See if it's enter */
      if (event->keyval == GDK_KEY_Return ||
          event->keyval == GDK_KEY_KP_Enter)
        {
          /* Check length and act accordingly */
          if (gtk_entry_get_text_length(GTK_ENTRY(widget)) == 0)
            {
              gtk_weather_run_error_dialog(GTK_WINDOW(data), 
                                           _("You must specify a location."));
            }
          else
            {
              gtk_dialog_response(GTK_DIALOG(data), GTK_RESPONSE_ACCEPT);
            }
          
        }
    }
  else if (GTK_IS_BUTTON(widget))
    {
      if (event->keyval == GDK_KEY_Return ||
          event->keyval == GDK_KEY_KP_Enter ||
          event->keyval == GDK_KEY_space)
        {
          /* Don't care about the return value or the event pointer */
          gtk_weather_change_location(GTK_WIDGET(data), NULL);
        }

    }

  return FALSE;
}

/* GTK helper functions */
/**
 * Creates and shows an error dialog.
 *
 * @param parent Parent window pointer.
 * @param error_msg Error message to display.
 */
static void
gtk_weather_run_error_dialog(GtkWindow * parent, gchar * error_msg)
{
  LXW_LOG(LXW_DEBUG, "GtkWeather::run_error_dialog(%s)", error_msg);

  static gboolean shown = FALSE;

  if (!shown)
    {
      GtkWidget * error_dialog = gtk_message_dialog_new(parent,
                                                        GTK_DIALOG_MODAL,
                                                        GTK_MESSAGE_ERROR,
                                                        GTK_BUTTONS_OK,
                                                        "%s", error_msg);
      
      gtk_weather_set_window_icon(GTK_WINDOW(error_dialog), "gtk-dialog-error");
      
      shown = TRUE;

      gtk_dialog_run(GTK_DIALOG(error_dialog));

      gtk_widget_destroy(error_dialog);

      shown = FALSE;
    }
}

#ifdef USE_STANDALONE
/**
 * Creates a pop-up menu.
 *
 * @param weather Pointer to the instance of this widget.
 */
static void
gtk_weather_create_popup_menu(GtkWeather * weather)
{
  LXW_LOG(LXW_DEBUG, "GtkWeather::create_popup_menu()");

  GtkWeatherPrivate * priv = GTK_WEATHER_GET_PRIVATE(weather);

  priv->menu_data.menu = gtk_menu_new();

  priv->menu_data.preferences_item = gtk_image_menu_item_new_with_label(_("Preferences"));
  
  gtk_image_menu_item_set_image(GTK_IMAGE_MENU_ITEM(priv->menu_data.preferences_item), 
                                gtk_image_new_from_stock(GTK_STOCK_PREFERENCES,
                                                         GTK_ICON_SIZE_MENU));
  
  priv->menu_data.refresh_item = gtk_image_menu_item_new_with_label(_("Refresh"));

  gtk_image_menu_item_set_image(GTK_IMAGE_MENU_ITEM(priv->menu_data.refresh_item), 
                                gtk_image_new_from_stock(GTK_STOCK_REFRESH,
                                                         GTK_ICON_SIZE_MENU));

  priv->menu_data.quit_item = gtk_image_menu_item_new_with_label(_("Quit"));

  gtk_image_menu_item_set_image(GTK_IMAGE_MENU_ITEM(priv->menu_data.quit_item), 
                                gtk_image_new_from_stock(GTK_STOCK_QUIT,
                                                         GTK_ICON_SIZE_MENU));

  gtk_menu_shell_append(GTK_MENU_SHELL(priv->menu_data.menu), priv->menu_data.preferences_item);

  gtk_menu_shell_append(GTK_MENU_SHELL(priv->menu_data.menu), gtk_separator_menu_item_new());

  gtk_menu_shell_append(GTK_MENU_SHELL(priv->menu_data.menu), priv->menu_data.refresh_item);

  gtk_menu_shell_append(GTK_MENU_SHELL(priv->menu_data.menu), gtk_separator_menu_item_new());

  gtk_menu_shell_append(GTK_MENU_SHELL(priv->menu_data.menu), priv->menu_data.quit_item);

  /* connect signals appropriately */
  g_signal_connect_swapped(G_OBJECT(priv->menu_data.preferences_item), 
                           "activate",
                           G_CALLBACK(gtk_weather_run_preferences_dialog),
                           weather);

  g_signal_connect_swapped(G_OBJECT(priv->menu_data.refresh_item),
                           "activate",
                           G_CALLBACK(gtk_weather_get_forecast),
                           weather);

  g_signal_connect_swapped(G_OBJECT(priv->menu_data.quit_item),
                           "activate",
                           G_CALLBACK(gtk_main_quit),
                           NULL);

  gtk_menu_attach_to_widget(GTK_MENU(priv->menu_data.menu), GTK_WIDGET(weather), NULL);

  gtk_widget_show_all(priv->menu_data.menu);
}
#endif

/**
 * Callback for the preferences menu response.
 *
 * @param dialog Pointer to the preferences dialog.
 * @param response ID of the response action.
 * @param data   Pointer to user data (weather widget instance).
 */
void
gtk_weather_preferences_dialog_response(GtkDialog *dialog, gint response, gpointer data)
{
  LXW_LOG(LXW_DEBUG, "GtkWeather::popup_menu(%d)", response);

  GtkWeather * weather = GTK_WEATHER(data);

  GtkWeatherPrivate * priv = GTK_WEATHER_GET_PRIVATE(weather);

  switch(response)
    {
    case GTK_RESPONSE_ACCEPT:
      if (priv->location)
        {
          LocationInfo * location = priv->location;

          setLocationAlias(priv->location, 
                           (gpointer)gtk_entry_get_text(GTK_ENTRY(priv->preferences_data.alias_entry)));
          
          location->bEnabled_ = gtk_toggle_button_get_active(GTK_TOGGLE_BUTTON(priv->preferences_data.auto_button));

          if (gtk_toggle_button_get_active(GTK_TOGGLE_BUTTON((priv->preferences_data.c_button))))
            {
              location->cUnits_ = 'c';
            }
          else
            {
              location->cUnits_ = 'f';
            }
          
          location->uiInterval_ = (guint)gtk_spin_button_get_value_as_int(GTK_SPIN_BUTTON(priv->preferences_data.auto_spin_button));

          /* Set this location as the valid one */
          copyLocation(&priv->previous_location, priv->location);          

          GtkTreeIter iter;
          if (gtk_combo_box_get_active_iter(GTK_COMBO_BOX(priv->preferences_data.provider_button),
                                            &iter))
            {
              GtkTreeModel *model = gtk_combo_box_get_model(GTK_COMBO_BOX(priv->preferences_data.provider_button));
              provider_callback_info *provider;

              gtk_tree_model_get(model, &iter, 1, (gpointer *)&provider, -1);
              gtk_weather_set_provider(weather, provider);
              // TODO: show error if failed
            }

          /* get forecast */
          gtk_weather_get_forecast(weather);

          gtk_weather_render(weather);

          weather_save_configuration(GTK_WIDGET(weather), location);
        }

      break;

    case GTK_RESPONSE_REJECT:
      gtk_weather_set_location(weather, priv->previous_location);
      
      gtk_weather_get_forecast(weather);

      break;
    default:
      /* Leave everything as-is*/
      break;
    }

  priv->preferences_data.dialog = NULL;
  
  priv->preferences_data.shown = FALSE;
}

#ifdef USE_STANDALONE
/**
 * Shows the popup menu used for configuration.
 *
 * @param widget Pointer to the current instance of the weather widget.
 */
void
gtk_weather_run_popup_menu(GtkWeather * weather)
{
  GtkWeatherPrivate * priv = GTK_WEATHER_GET_PRIVATE(weather);

  LXW_LOG(LXW_DEBUG, "GtkWeather::popup_menu()");

  gtk_widget_show(GTK_WIDGET(priv->menu_data.quit_item));

  /* grey-out refresh, if no location is set */
  if (!priv->location)
    {
      gtk_widget_set_sensitive(priv->menu_data.refresh_item, FALSE);
    }
  else
    {
      gtk_widget_set_sensitive(priv->menu_data.refresh_item, TRUE);
    }
  
  gtk_menu_popup(GTK_MENU(priv->menu_data.menu), 
                 NULL, NULL, NULL, NULL, 
                 3, // right-click
                 gtk_get_current_event_time());
  
}
#endif

/**
 * Creates the preferences dialog.
 *
 * @param widget Pointer to the current instance of the weather object.
 *
 * @return pointer to the preferences dialog, or NULL on failure.
 */
GtkWidget *
gtk_weather_create_preferences_dialog(GtkWeather * weather, provider_callback_info ** list)
{
  /* @NOTE: watch for parent window when dealing with the plugin */
  /* @TODO: connect the response signal to the proper function */
  LXW_LOG(LXW_DEBUG, "GtkWeather::create_preferences_dialog()");

  GtkWeatherPrivate * priv = GTK_WEATHER_GET_PRIVATE(weather);

  priv->preferences_data.dialog = gtk_dialog_new_with_buttons(_("Weather Preferences"),
                                                              NULL,
                                                              GTK_DIALOG_MODAL | GTK_DIALOG_DESTROY_WITH_PARENT,
                                                              GTK_STOCK_OK, GTK_RESPONSE_ACCEPT,
                                                              GTK_STOCK_CANCEL, GTK_RESPONSE_REJECT,
                                                              NULL);

  /* Set dialog window icon */
  gtk_weather_set_window_icon(GTK_WINDOW(priv->preferences_data.dialog), "gtk-preferences");

  gtk_window_set_resizable(GTK_WINDOW(priv->preferences_data.dialog), FALSE);

  gtk_dialog_set_default_response(GTK_DIALOG(priv->preferences_data.dialog), GTK_RESPONSE_ACCEPT);

  GtkWidget * location_frame = gtk_frame_new(_("Current Location"));

  GtkWidget * location_hbox = gtk_hbox_new(FALSE, 1);

  priv->preferences_data.location_label = gtk_label_new(_("None configured"));

  priv->preferences_data.location_button = gtk_button_new_with_mnemonic(_("_Set"));

  g_signal_connect(G_OBJECT(priv->preferences_data.location_button),
                   "key-press-event",
                   G_CALLBACK(gtk_weather_key_pressed),
                   (gpointer)weather);

  g_signal_connect_swapped(G_OBJECT(priv->preferences_data.location_button),
                           "button-press-event", 
                           G_CALLBACK(gtk_weather_change_location),
                           GTK_WIDGET(weather));

  gtk_box_pack_start(GTK_BOX(location_hbox), 
                     priv->preferences_data.location_label, 
                     TRUE, FALSE, 1);

  gtk_box_pack_end(GTK_BOX(location_hbox),
                   priv->preferences_data.location_button, FALSE, FALSE, 10);

  gtk_container_add(GTK_CONTAINER(location_frame), location_hbox);

  GtkWidget * display_frame = gtk_frame_new(_("Display"));

  GtkWidget * display_table = gtk_table_new(2, 2, FALSE);

  GtkWidget * alias_label = gtk_label_new(_("Name:"));

  priv->preferences_data.alias_entry = gtk_entry_new(); 

  GtkWidget * button_label = gtk_label_new(_("Units:"));

  GtkWidget * button_hbox = gtk_hbox_new(TRUE, 10);

  priv->preferences_data.c_button = gtk_radio_button_new_with_mnemonic(NULL, _("_Metric (\302\260C)"));

  priv->preferences_data.f_button = gtk_radio_button_new_with_mnemonic_from_widget(GTK_RADIO_BUTTON(priv->preferences_data.c_button), _("_English (\302\260F)"));

  gtk_box_pack_end(GTK_BOX(button_hbox), priv->preferences_data.c_button, FALSE, FALSE, 1);
  gtk_box_pack_end(GTK_BOX(button_hbox), priv->preferences_data.f_button, FALSE, FALSE, 1);

  gtk_table_attach(GTK_TABLE(display_table), 
                   alias_label,
                   0,1,0,1,
                   GTK_EXPAND | GTK_FILL | GTK_SHRINK,
                   GTK_EXPAND | GTK_FILL | GTK_SHRINK,
                   10,5);

  gtk_table_attach(GTK_TABLE(display_table), 
                   priv->preferences_data.alias_entry,
                   1,2,0,1,
                   GTK_EXPAND | GTK_FILL | GTK_SHRINK,
                   GTK_EXPAND | GTK_FILL | GTK_SHRINK,
                   10,5);

  gtk_table_attach(GTK_TABLE(display_table), 
                   button_label,
                   0,1,1,2,
                   GTK_EXPAND | GTK_FILL | GTK_SHRINK,
                   GTK_EXPAND | GTK_FILL | GTK_SHRINK,
                   10,5);

  gtk_table_attach(GTK_TABLE(display_table), 
                   button_hbox,
                   1,2,1,2,
                   GTK_EXPAND | GTK_FILL | GTK_SHRINK,
                   GTK_EXPAND | GTK_FILL | GTK_SHRINK,
                   10,5);

  gtk_container_add(GTK_CONTAINER(display_frame), display_table);

  GtkWidget * forecast_frame = gtk_frame_new(_("Forecast"));

  GtkWidget * forecast_table = gtk_table_new(2, 2, FALSE);

  GtkWidget * update_label = gtk_label_new(_("Updates:"));

  GtkWidget * update_vbox = gtk_vbox_new(TRUE, 10);

  priv->preferences_data.manual_button = gtk_radio_button_new_with_mnemonic(NULL, _("Ma_nual"));

  priv->preferences_data.auto_button = 
    gtk_radio_button_new_with_mnemonic_from_widget(GTK_RADIO_BUTTON(priv->preferences_data.manual_button), 
                                                   _("_Automatic, every"));

  g_signal_connect_swapped(G_OBJECT(priv->preferences_data.manual_button),
                           "toggled",
                           G_CALLBACK(gtk_weather_auto_update_toggled),
                           weather);

  g_signal_connect(G_OBJECT(priv->preferences_data.dialog),
                   "response",
                   G_CALLBACK(gtk_weather_preferences_dialog_response),
                   weather);

  /*  g_signal_connect_swapped(G_OBJECT(priv->preferences_data.auto_button),
                           "toggled",
                           G_CALLBACK(gtk_weather_auto_update_toggled),
                           weather);*/

  GtkWidget * auto_hbox = gtk_hbox_new(FALSE, 2);

  priv->preferences_data.auto_spin_button = gtk_spin_button_new_with_range(20, 120, 10);
  
  GtkWidget * auto_min_label = gtk_label_new(_("minutes"));

  gtk_box_pack_start(GTK_BOX(auto_hbox), priv->preferences_data.auto_button, FALSE, FALSE, 1);
  gtk_box_pack_start(GTK_BOX(auto_hbox), priv->preferences_data.auto_spin_button, FALSE, FALSE, 1);
  gtk_box_pack_start(GTK_BOX(auto_hbox), auto_min_label, FALSE, FALSE, 1);

  gtk_box_pack_start(GTK_BOX(update_vbox), priv->preferences_data.manual_button, TRUE, TRUE, 0);
  gtk_box_pack_start(GTK_BOX(update_vbox), auto_hbox, TRUE, TRUE, 0);

  GtkWidget * source_label = gtk_label_new(_("Source:"));

  GtkListStore *provider_model = gtk_list_store_new(2, G_TYPE_STRING, G_TYPE_POINTER);
  gint provider_active = -1;
  while (list && *list)
    {
      GtkTreeIter iter;

      gtk_list_store_append(provider_model, &iter);
      gtk_list_store_set(provider_model, &iter, 0, _((*list)->description),
                                                1, *list, -1);
      if (*list == priv->provider)
        {
          GtkTreePath *path = gtk_tree_model_get_path(GTK_TREE_MODEL(provider_model), &iter);
          gint *indices = gtk_tree_path_get_indices(path);
          provider_active = indices[0];
          gtk_tree_path_free(path);
        }
      list++;
    }
  GtkWidget * provider_button = gtk_combo_box_new_with_model(GTK_TREE_MODEL(provider_model));
  priv->preferences_data.provider_button = provider_button;
  GtkCellRenderer * column = gtk_cell_renderer_text_new();
  g_object_unref(provider_model);
  gtk_cell_layout_pack_start(GTK_CELL_LAYOUT(provider_button), column, TRUE);
  gtk_cell_layout_set_attributes(GTK_CELL_LAYOUT(provider_button), column, "text", 0, NULL);
  gtk_combo_box_set_active(GTK_COMBO_BOX(provider_button), provider_active);

  gtk_table_attach(GTK_TABLE(forecast_table), 
                   update_label,
                   0,1,0,1,
                   GTK_EXPAND | GTK_FILL | GTK_SHRINK,
                   GTK_EXPAND | GTK_FILL | GTK_SHRINK,
                   10,5);

  gtk_table_attach(GTK_TABLE(forecast_table), 
                   update_vbox,
                   1,2,0,1,
                   GTK_EXPAND | GTK_FILL | GTK_SHRINK,
                   GTK_EXPAND | GTK_FILL | GTK_SHRINK,
                   10,5);

  gtk_table_attach(GTK_TABLE(forecast_table), 
                   source_label,
                   0,1,1,2,
                   GTK_EXPAND | GTK_FILL | GTK_SHRINK,
                   GTK_EXPAND | GTK_FILL | GTK_SHRINK,
                   10,5);

  gtk_table_attach(GTK_TABLE(forecast_table), 
                   provider_button,
                   1,2,1,2,
                   GTK_EXPAND | GTK_FILL | GTK_SHRINK,
                   GTK_EXPAND | GTK_FILL | GTK_SHRINK,
                   10,5);

  gtk_container_add(GTK_CONTAINER(forecast_frame), forecast_table);

  /* VBox packing starts here */
  gtk_box_pack_start(GTK_BOX(gtk_dialog_get_content_area(GTK_DIALOG(priv->preferences_data.dialog))),
                     location_frame, TRUE, TRUE, 0);

  gtk_box_pack_start(GTK_BOX(gtk_dialog_get_content_area(GTK_DIALOG(priv->preferences_data.dialog))),
                     display_frame, TRUE, TRUE, 0);

  gtk_box_pack_start(GTK_BOX(gtk_dialog_get_content_area(GTK_DIALOG(priv->preferences_data.dialog))),
                     forecast_frame, TRUE, TRUE, 0);

  gtk_weather_update_preferences_dialog(weather);

  gtk_widget_show_all(priv->preferences_data.dialog);

  return priv->preferences_data.dialog;
}

#ifdef USE_STANDALONE
/**
 * Creates and shows the preferences dialog.
 *
 * @param widget Pointer to the current instance of the weather object.
 */
void
gtk_weather_run_preferences_dialog(GtkWeather * weather)
{
  /* @NOTE: watch for parent window when dealing with the plugin */
  LXW_LOG(LXW_DEBUG, "GtkWeather::run_preferences_dialog()");

  GtkWeatherPrivate * priv = GTK_WEATHER_GET_PRIVATE(weather);

  if (priv->preferences_data.shown)
    {
      return;
    }

  /* this dialog is the same one as priv->preferences_data.dialog */
  GtkWidget * dialog = gtk_weather_create_preferences_dialog(weather);

  g_signal_connect(G_OBJECT(dialog), "response", G_CALLBACK(gtk_widget_destroy), NULL);

  priv->preferences_data.shown = TRUE;
}
#endif

/**
 * Creates and shows the preferences dialog window
 *
 * @param weather Pointer to the instance of this widget.
 */
static void
gtk_weather_update_preferences_dialog(GtkWeather * weather)
{
  // @NOTE: watch for parent window when dealing with the plugin.
  // @TODO: possibly set the position of dialog window right in the middle of the screen.
  LXW_LOG(LXW_DEBUG, "GtkWeather::update_preferences_dialog()");

  GtkWeatherPrivate * priv = GTK_WEATHER_GET_PRIVATE(weather);

  if (!priv->preferences_data.dialog)
    {
      return;
    }

  if (priv->location)
    {
      LocationInfo * location = priv->location;

      /* populate location_label */
      gchar * loc = g_strconcat((location->pcCity_)?location->pcCity_:"",
                                (location->pcCity_ && location->pcState_)?", ":"",
                                (location->pcState_)?location->pcState_:"",
                                (location->pcCountry_)?", ":"",
                                (location->pcCountry_)?location->pcCountry_:"",
                                NULL);

      gtk_label_set_text(GTK_LABEL(priv->preferences_data.location_label), loc);

      gtk_button_set_label(GTK_BUTTON(priv->preferences_data.location_button), _("C_hange"));

      /* populate the alias entry with pcAlias_ */
      gtk_widget_set_sensitive(priv->preferences_data.alias_entry, TRUE);
      if (location->pcAlias_)
        gtk_entry_set_text(GTK_ENTRY(priv->preferences_data.alias_entry), location->pcAlias_);
      else if (location->pcCity_)
        gtk_entry_set_text(GTK_ENTRY(priv->preferences_data.alias_entry), location->pcCity_);
      else
        gtk_entry_set_text(GTK_ENTRY(priv->preferences_data.alias_entry), location->pcState_);

      gtk_widget_set_sensitive(priv->preferences_data.c_button, TRUE);
      gtk_widget_set_sensitive(priv->preferences_data.f_button, TRUE);

      gtk_widget_set_sensitive(priv->preferences_data.manual_button, TRUE);
      gtk_widget_set_sensitive(priv->preferences_data.auto_button, TRUE);

      /* populate/activate proper c/f button */  
      if (location->cUnits_ == 'c')
        {
          gtk_toggle_button_set_active(GTK_TOGGLE_BUTTON(priv->preferences_data.c_button), TRUE);
          gtk_toggle_button_set_active(GTK_TOGGLE_BUTTON(priv->preferences_data.f_button), FALSE);
        }
      else
        {
          gtk_toggle_button_set_active(GTK_TOGGLE_BUTTON(priv->preferences_data.c_button), FALSE);
          gtk_toggle_button_set_active(GTK_TOGGLE_BUTTON(priv->preferences_data.f_button), TRUE);
        }

      /* populate/activate auto/manual button with auto-spin, if configured */
      if (location->bEnabled_)
        {
          gtk_toggle_button_set_active(GTK_TOGGLE_BUTTON(priv->preferences_data.auto_button), TRUE);
          gtk_toggle_button_set_active(GTK_TOGGLE_BUTTON(priv->preferences_data.manual_button), FALSE);
          gtk_widget_set_sensitive(GTK_WIDGET(priv->preferences_data.auto_spin_button), TRUE);
          gtk_spin_button_set_value(GTK_SPIN_BUTTON(priv->preferences_data.auto_spin_button), 
                                    (gdouble)((location->uiInterval_) ? location->uiInterval_ : 60));
        }
      else
        {
          gtk_toggle_button_set_active(GTK_TOGGLE_BUTTON(priv->preferences_data.auto_button), FALSE);
          gtk_toggle_button_set_active(GTK_TOGGLE_BUTTON(priv->preferences_data.manual_button), TRUE);
          gtk_widget_set_sensitive(GTK_WIDGET(priv->preferences_data.auto_spin_button), FALSE);
        }

      g_free(loc);
    }
  else
    {
      gtk_button_set_label(GTK_BUTTON(priv->preferences_data.location_button), _("_Set"));

      gtk_label_set_text(GTK_LABEL(priv->preferences_data.location_label),
                         _("None configured"));

      gtk_entry_set_text(GTK_ENTRY(priv->preferences_data.alias_entry), "");
      
      gtk_widget_set_sensitive(priv->preferences_data.alias_entry, FALSE);

      gtk_widget_set_sensitive(priv->preferences_data.c_button, FALSE);
      gtk_widget_set_sensitive(priv->preferences_data.f_button, FALSE);

      gtk_widget_set_sensitive(priv->preferences_data.auto_button, FALSE);
      gtk_widget_set_sensitive(priv->preferences_data.manual_button, FALSE);
      gtk_widget_set_sensitive(GTK_WIDGET(priv->preferences_data.auto_spin_button), FALSE);
    }

}

/**
 * Creates and shows the current conditions dialog.
 *
 * @param widget Pointer to the current instance of the weather object.
 */
void
gtk_weather_run_conditions_dialog(GtkWeather * weather)
{
  LXW_LOG(LXW_DEBUG, "GtkWeather::run_conditions_dialog()");

  GtkWeatherPrivate * priv = GTK_WEATHER_GET_PRIVATE(weather);

  LocationInfo * location = priv->location;
  ForecastInfo * forecast = priv->forecast;

  if (location && forecast)
    {
      if (priv->conditions_dialog)
        {
          return;
        }

      /* Both are available */
      gchar * dialog_title = g_strdup_printf(_("Current Conditions for %s"), 
                                             (location)?location->pcAlias_:"");

      GtkWidget * dialog = gtk_dialog_new_with_buttons(dialog_title,
                                                       NULL,
                                                       GTK_DIALOG_MODAL | GTK_DIALOG_DESTROY_WITH_PARENT,
                                                       GTK_STOCK_REFRESH, GTK_RESPONSE_APPLY,
                                                       GTK_STOCK_OK, GTK_RESPONSE_ACCEPT,
                                                       NULL);

      GtkWidget * everything_hbox = gtk_hbox_new(FALSE, 5);

      /* This vbox gets filled-in when the table is populated */
      GtkWidget * icon_vbox = gtk_vbox_new(FALSE, 1);

      GtkWidget * forecast_table = gtk_table_new(9, 2, FALSE);

      gchar * location_label_text = g_strconcat((location->pcCity_)?location->pcCity_:"",
                                                (location->pcCity_ && location->pcState_)?", ":"",
                                                (location->pcState_)?location->pcState_:"",
                                                (location->pcCountry_)?", ":"",
                                                (location->pcCountry_)?location->pcCountry_:"",
                                                NULL);

      GtkWidget * location_name_label = gtk_label_new(_("Location:"));
      GtkWidget * location_name_text  = gtk_label_new(location_label_text);

      GtkWidget * label_alignment = gtk_alignment_new(0, 0.5, 0, 0);
      GtkWidget * text_alignment = gtk_alignment_new(0, 0.5, 0, 0);

      gtk_container_add(GTK_CONTAINER(label_alignment), location_name_label);
      gtk_container_add(GTK_CONTAINER(text_alignment), location_name_text);
      
      gtk_table_attach(GTK_TABLE(forecast_table), 
                       label_alignment,
                       0,1,0,1,
                       GTK_EXPAND | GTK_FILL | GTK_SHRINK,
                       GTK_EXPAND | GTK_FILL | GTK_SHRINK,
                       2,2);

      gtk_table_attach(GTK_TABLE(forecast_table), 
                       text_alignment,
                       1,2,0,1,
                       GTK_EXPAND | GTK_FILL | GTK_SHRINK,
                       GTK_EXPAND | GTK_FILL | GTK_SHRINK,
                       2,2);

      GtkWidget * updated_label = gtk_label_new(_("Last updated:"));
      GtkWidget * updated_text = gtk_label_new(forecast->pcTime_);

      GtkWidget * updated_alignment = gtk_alignment_new(0, 0.5, 0, 0);
      GtkWidget * updated_text_alignment = gtk_alignment_new(0, 0.5, 0, 0);

      gtk_container_add(GTK_CONTAINER(updated_alignment), updated_label);
      gtk_container_add(GTK_CONTAINER(updated_text_alignment), updated_text);

      gtk_table_attach(GTK_TABLE(forecast_table), 
                       updated_alignment,
                       0,1,1,2,
                       GTK_EXPAND | GTK_FILL | GTK_SHRINK,
                       GTK_EXPAND | GTK_FILL | GTK_SHRINK,
                       2,2);

      gtk_table_attach(GTK_TABLE(forecast_table), 
                       updated_text_alignment,
                       1,2,1,2,
                       GTK_EXPAND | GTK_FILL | GTK_SHRINK,
                       GTK_EXPAND | GTK_FILL | GTK_SHRINK,
                       2,2);

      gchar * feels = NULL;

      if (forecast->iWindChill_ > -1000) /* has a valid value */
        {
          feels = g_strdup_printf("%d \302\260%s",
                          /* Yahoo reports chill always in Fahreheit degrees */
                                  (location->cUnits_ == 'c') ?
                                  (forecast->iWindChill_ - 32) * 5 / 9 :
                                  forecast->iWindChill_,
                                  forecast->units_.pcTemperature_);

          GtkWidget * feels_label = gtk_label_new(_("Feels like:"));
          GtkWidget * feels_text = gtk_label_new(feels);

          GtkWidget * feels_alignment = gtk_alignment_new(0, 0.5, 0, 0);
          gtk_container_add(GTK_CONTAINER(feels_alignment), feels_label);

          GtkWidget * feels_text_alignment = gtk_alignment_new(0, 0.5, 0, 0);
          gtk_container_add(GTK_CONTAINER(feels_text_alignment), feels_text);

          gtk_table_attach(GTK_TABLE(forecast_table),
                           feels_alignment,
                           0,1,2,3,
                           GTK_EXPAND | GTK_FILL | GTK_SHRINK,
                           GTK_EXPAND | GTK_FILL | GTK_SHRINK,
                           2,2);

          gtk_table_attach(GTK_TABLE(forecast_table),
                           feels_text_alignment,
                           1,2,2,3,
                           GTK_EXPAND | GTK_FILL | GTK_SHRINK,
                           GTK_EXPAND | GTK_FILL | GTK_SHRINK,
                           2,2);
        }

      gchar * humidity = g_strdup_printf("%d%%", forecast->iHumidity_);

      GtkWidget * humidity_label = gtk_label_new(_("Humidity:"));
      GtkWidget * humidity_text = gtk_label_new(humidity);

      GtkWidget * humidity_alignment = gtk_alignment_new(0, 0.5, 0, 0);
      gtk_container_add(GTK_CONTAINER(humidity_alignment), humidity_label);

      GtkWidget * humidity_text_alignment = gtk_alignment_new(0, 0.5, 0, 0);
      gtk_container_add(GTK_CONTAINER(humidity_text_alignment), humidity_text);

      gtk_table_attach(GTK_TABLE(forecast_table), 
                       humidity_alignment,
                       0,1,3,4,
                       GTK_EXPAND | GTK_FILL | GTK_SHRINK,
                       GTK_EXPAND | GTK_FILL | GTK_SHRINK,
                       2,2);

      gtk_table_attach(GTK_TABLE(forecast_table), 
                       humidity_text_alignment,
                       1,2,3,4,
                       GTK_EXPAND | GTK_FILL | GTK_SHRINK,
                       GTK_EXPAND | GTK_FILL | GTK_SHRINK,
                       2,2);

      gchar * pressure = g_strdup_printf("%ld %s",
                                         (glong) forecast->dPressure_,
                                         forecast->units_.pcPressure_);

      GtkWidget * pressure_label = gtk_label_new(_("Pressure:"));
      GtkWidget * pressure_text = gtk_label_new(pressure);

      GtkWidget * pressure_alignment = gtk_alignment_new(0, 0.5, 0, 0);
      gtk_container_add(GTK_CONTAINER(pressure_alignment), pressure_label);

      GtkWidget * pressure_text_alignment = gtk_alignment_new(0, 0.5, 0, 0);
      gtk_container_add(GTK_CONTAINER(pressure_text_alignment), pressure_text);

      gtk_table_attach(GTK_TABLE(forecast_table), 
                       pressure_alignment,
                       0,1,4,5,
                       GTK_EXPAND | GTK_FILL | GTK_SHRINK,
                       GTK_EXPAND | GTK_FILL | GTK_SHRINK,
                       2,2);

      gtk_table_attach(GTK_TABLE(forecast_table), 
                       pressure_text_alignment,
                       1,2,4,5,
                       GTK_EXPAND | GTK_FILL | GTK_SHRINK,
                       GTK_EXPAND | GTK_FILL | GTK_SHRINK,
                       2,2);

      gchar * visibility = g_strdup_printf("%ld %s",
                                         (glong) forecast->dVisibility_,
                                         forecast->units_.pcDistance_);

      GtkWidget * visibility_label = gtk_label_new(_("Visibility:"));
      GtkWidget * visibility_text = gtk_label_new(visibility);

      GtkWidget * visibility_alignment = gtk_alignment_new(0, 0.5, 0, 0);
      gtk_container_add(GTK_CONTAINER(visibility_alignment), visibility_label);

      GtkWidget * visibility_text_alignment = gtk_alignment_new(0, 0.5, 0, 0);
      gtk_container_add(GTK_CONTAINER(visibility_text_alignment), visibility_text);

      gtk_table_attach(GTK_TABLE(forecast_table), 
                       visibility_alignment,
                       0,1,5,6,
                       GTK_EXPAND | GTK_FILL | GTK_SHRINK,
                       GTK_EXPAND | GTK_FILL | GTK_SHRINK,
                       2,2);

      gtk_table_attach(GTK_TABLE(forecast_table), 
                       visibility_text_alignment,
                       1,2,5,6,
                       GTK_EXPAND | GTK_FILL | GTK_SHRINK,
                       GTK_EXPAND | GTK_FILL | GTK_SHRINK,
                       2,2);

      gchar * wind = g_strdup_printf("%s%s%d %s",
                                     forecast->pcWindDirection_ ? forecast->pcWindDirection_ : "",
                                     forecast->pcWindDirection_ ? ", ": "",
                                     forecast->iWindSpeed_,
                                     forecast->units_.pcSpeed_);

      GtkWidget * wind_label = gtk_label_new(_("Wind:"));
      GtkWidget * wind_text = gtk_label_new(wind);

      GtkWidget * wind_alignment = gtk_alignment_new(0, 0.5, 0, 0);
      gtk_container_add(GTK_CONTAINER(wind_alignment), wind_label);

      GtkWidget * wind_text_alignment = gtk_alignment_new(0, 0.5, 0, 0);
      gtk_container_add(GTK_CONTAINER(wind_text_alignment), wind_text);

      gtk_table_attach(GTK_TABLE(forecast_table), 
                       wind_alignment,
                       0,1,6,7,
                       GTK_EXPAND | GTK_FILL | GTK_SHRINK,
                       GTK_EXPAND | GTK_FILL | GTK_SHRINK,
                       2,2);

      gtk_table_attach(GTK_TABLE(forecast_table), 
                       wind_text_alignment,
                       1,2,6,7,
                       GTK_EXPAND | GTK_FILL | GTK_SHRINK,
                       GTK_EXPAND | GTK_FILL | GTK_SHRINK,
                       2,2);

      GtkWidget * sunrise_label = gtk_label_new(_("Sunrise:"));
      GtkWidget * sunrise_text = gtk_label_new(forecast->pcSunrise_);

      GtkWidget * sunrise_alignment = gtk_alignment_new(0, 0.5, 0, 0);
      gtk_container_add(GTK_CONTAINER(sunrise_alignment), sunrise_label);

      GtkWidget * sunrise_text_alignment = gtk_alignment_new(0, 0.5, 0, 0);
      gtk_container_add(GTK_CONTAINER(sunrise_text_alignment), sunrise_text);

      gtk_table_attach(GTK_TABLE(forecast_table), 
                       sunrise_alignment,
                       0,1,7,8,
                       GTK_EXPAND | GTK_FILL | GTK_SHRINK,
                       GTK_EXPAND | GTK_FILL | GTK_SHRINK,
                       2,2);

      gtk_table_attach(GTK_TABLE(forecast_table), 
                       sunrise_text_alignment,
                       1,2,7,8,
                       GTK_EXPAND | GTK_FILL | GTK_SHRINK,
                       GTK_EXPAND | GTK_FILL | GTK_SHRINK,
                       2,2);

      GtkWidget * sunset_label = gtk_label_new(_("Sunset:"));
      GtkWidget * sunset_text = gtk_label_new(forecast->pcSunset_);

      GtkWidget * sunset_alignment = gtk_alignment_new(0, 0.5, 0, 0);
      gtk_container_add(GTK_CONTAINER(sunset_alignment), sunset_label);

      GtkWidget * sunset_text_alignment = gtk_alignment_new(0, 0.5, 0, 0);
      gtk_container_add(GTK_CONTAINER(sunset_text_alignment), sunset_text);

      gtk_table_attach(GTK_TABLE(forecast_table), 
                       sunset_alignment,
                       0,1,8,9,
                       GTK_EXPAND | GTK_FILL | GTK_SHRINK,
                       GTK_EXPAND | GTK_FILL | GTK_SHRINK,
                       2,2);

      gtk_table_attach(GTK_TABLE(forecast_table), 
                       sunset_text_alignment,
                       1,2,8,9,
                       GTK_EXPAND | GTK_FILL | GTK_SHRINK,
                       GTK_EXPAND | GTK_FILL | GTK_SHRINK,
                       2,2);

      /* Image and conditions label. Image is filled after dialog is shown 
       * to nicely scale the image pixbuf.
       */
      GtkWidget * icon_image = gtk_image_new_from_stock(GTK_STOCK_MISSING_IMAGE,
                                                        GTK_ICON_SIZE_MENU);

      gchar * conditions_label_text = g_strdup_printf("<b>%s%s%s\n\n%d \302\260%s</b>",
                                                      forecast->pcClouds_ ? forecast->pcClouds_ : "",
                                                      (forecast->pcConditions_ && forecast->pcClouds_) ? ", " : "",
                                                      forecast->pcConditions_ ? forecast->pcConditions_ : "",
                                                      forecast->iTemperature_,
                                                      forecast->units_.pcTemperature_);

      GtkWidget * conditions_label = gtk_label_new(NULL);
      gtk_label_set_justify(GTK_LABEL(conditions_label), GTK_JUSTIFY_CENTER);
      gtk_label_set_markup(GTK_LABEL(conditions_label), conditions_label_text);

      /* Pack boxes */
      gtk_box_pack_start(GTK_BOX(icon_vbox), icon_image, FALSE, FALSE, 1);
      gtk_box_pack_start(GTK_BOX(icon_vbox), conditions_label, FALSE, FALSE, 1);

      gtk_box_pack_start(GTK_BOX(everything_hbox), icon_vbox, TRUE, TRUE, 35);
      gtk_box_pack_start(GTK_BOX(everything_hbox), forecast_table, FALSE, FALSE, 5);

      /* Free everything */
      g_free(conditions_label_text);
      g_free(wind);
      g_free(visibility);
      g_free(pressure);
      g_free(feels);
      g_free(humidity);
      g_free(location_label_text);
      g_free(dialog_title);
      
      gtk_box_pack_start(GTK_BOX(gtk_dialog_get_content_area(GTK_DIALOG(dialog))), everything_hbox, FALSE, FALSE, 5);

  
      /* Set dialog window icon */
      gtk_weather_set_window_icon(GTK_WINDOW(dialog), "gtk-about");

      gtk_window_set_resizable(GTK_WINDOW(dialog), FALSE);

      gtk_dialog_set_default_response(GTK_DIALOG(dialog), GTK_RESPONSE_ACCEPT);

      priv->conditions_dialog = dialog;

      gtk_widget_show_all(dialog);

      /* Get dimensions to create proper icon... */
      GtkRequisition req;

      gtk_widget_size_request(dialog, &req);

      /* Need the minimum */
      gint dim = (req.width < req.height) ? req.width/2 : req.height/2;

      GdkPixbuf * icon_buf = gdk_pixbuf_scale_simple(forecast->pBigImage_ ? forecast->pBigImage_ : forecast->pImage_,
                                                     dim, dim,
                                                     GDK_INTERP_BILINEAR);

      gtk_image_set_from_pixbuf(GTK_IMAGE(icon_image), icon_buf);

      g_object_unref(icon_buf);

      gint response = GTK_RESPONSE_NONE;

      do
        {
          response = gtk_dialog_run(GTK_DIALOG(dialog));

          if (response == GTK_RESPONSE_APPLY)
            {
              gtk_weather_get_forecast(weather);
            }

        }  while (response != GTK_RESPONSE_ACCEPT && response != GTK_RESPONSE_DELETE_EVENT);

      if (GTK_IS_WIDGET(dialog))
        {
          gtk_widget_destroy(dialog);
        }

      priv->conditions_dialog = NULL;
    }
  else if (!forecast && location)
    {
      gchar * error_msg = g_strdup_printf(_("Forecast for %s unavailable."),
                                          location->pcAlias_);

      gtk_weather_run_error_dialog(NULL, error_msg);

      g_free(error_msg);
    }
  else
    {
      gtk_weather_run_error_dialog(NULL, _("Location not set."));
    }
  
}

/**
 * Creates and shows the location retrieval progress bar.
 *
 * @param weather Pointer to the instance of this widget.
 */
static void
gtk_weather_show_location_progress_bar(GtkWeather * weather)
{
  LXW_LOG(LXW_DEBUG, "GtkWeather::show_location_progress_bar()");

  GtkWeatherPrivate * priv = GTK_WEATHER_GET_PRIVATE(weather);

  gchar * progress_str = g_strdup_printf(_("Searching for '%s'..."), priv->location_data.location);

  GtkWidget * dialog = gtk_dialog_new_with_buttons(progress_str,
                                                   GTK_WINDOW(priv->preferences_data.dialog),
                                                   GTK_DIALOG_DESTROY_WITH_PARENT,
                                                   GTK_STOCK_CANCEL,
                                                   GTK_RESPONSE_CANCEL,
                                                   NULL);

  //  gtk_window_set_decorated(GTK_WINDOW(dialog), FALSE);

  GtkWidget * alignment = gtk_alignment_new(0.5, 0.5, 0.5, 0.5);

  GtkWidget * progress_bar = gtk_progress_bar_new();

  priv->location_data.progress_bar = GTK_PROGRESS_BAR(progress_bar);

  priv->location_data.progress_dialog = dialog;

  gtk_progress_bar_set_text(GTK_PROGRESS_BAR(progress_bar), progress_str);

  gtk_progress_bar_set_fraction(GTK_PROGRESS_BAR(progress_bar), 0.5);

  gtk_container_add(GTK_CONTAINER(alignment), progress_bar);

  gtk_box_pack_start(GTK_BOX(gtk_dialog_get_content_area(GTK_DIALOG(dialog))), alignment, TRUE, TRUE, 0);

  int timer = g_timeout_add(500, gtk_weather_update_location_progress_bar, &priv->location_data);

  gtk_widget_show_all(dialog);

  gint response = gtk_dialog_run(GTK_DIALOG(dialog));

  switch(response)
    {
    case GTK_RESPONSE_ACCEPT:
      break;

    case GTK_RESPONSE_CANCEL:
      if (pthread_kill(*(priv->location_data.tid), 0) != ESRCH)
        {
          int ret = pthread_cancel(*(priv->location_data.tid));

          if (ret != 0)
            {
              LOG_ERRNO(ret, "pthread_cancel");
            }
        }

      break;

    default:
      break;
    }
  
  if (GTK_IS_WIDGET(dialog))
    {
      gtk_widget_destroy(dialog);
    }

  g_source_remove(timer);

  g_free(progress_str);

}

/**
 * Updates the location progress bar at regular intervals.
 *
 * @param data Pointer to the location thread data
 */
static gboolean
gtk_weather_update_location_progress_bar(gpointer data)
{
  LocationThreadData * location_data = (LocationThreadData *)data;

  LXW_LOG(LXW_DEBUG, "GtkWeather::update_location_progress_bar(): %d percent complete.", 
          (location_data)?(int)(gtk_progress_bar_get_fraction(location_data->progress_bar) * 100):-1);

  if (!location_data)
    {
      return FALSE;
    }

  gboolean ret = TRUE;

  /* Get the percentage */

  /* If it's less than 100, check the thread. 
   * If the thread is still running, increment percentage.
   * Otherwise, cancel thread - something's wrong.
   */
  gint percentage = gtk_progress_bar_get_fraction(location_data->progress_bar) * 100;

  if ( (percentage >= 100) ||
       (pthread_kill(*(location_data->tid), 0) == ESRCH) )
    {
      gtk_widget_destroy(location_data->progress_dialog);

      ret = FALSE;
    }
  else
    {
      percentage += 10;

      gtk_progress_bar_set_fraction(location_data->progress_bar, (gdouble)percentage/100);

      ret = TRUE;
    }
  
  return ret;
}

/**
 * Creates and shows the location list selection dialog.
 *
 * @param weather Pointer to the instance of this widget.
 * @param list   Pointer to the list of retrieved locations.
 */
static void
gtk_weather_show_location_list(GtkWeather * weather, GList * list)
{
  LXW_LOG(LXW_DEBUG, "GtkWeather::show_location_list(%d)", g_list_length(list));

  GtkWeatherPrivate * priv = GTK_WEATHER_GET_PRIVATE(weather);

  gchar * dialog_str = g_strdup_printf(_("Location matches for '%s'"), 
                                       priv->location_data.location);

  GtkWidget * dialog = gtk_dialog_new_with_buttons(dialog_str,
                                                   GTK_WINDOW(priv->preferences_data.dialog),
                                                   GTK_DIALOG_MODAL | GTK_DIALOG_DESTROY_WITH_PARENT,
                                                   GTK_STOCK_OK, GTK_RESPONSE_ACCEPT,
                                                   GTK_STOCK_CANCEL, GTK_RESPONSE_REJECT,
                                                   NULL);

  gtk_widget_set_size_request(dialog, 400, 300);

  /* Set dialog window icon */
  gtk_weather_set_window_icon(GTK_WINDOW(dialog), "gtk-properties");

  /* TreeView */
  GtkWidget * treeview = gtk_tree_view_new();

  /* city */
  GtkCellRenderer * cell_renderer = gtk_cell_renderer_text_new();
  GtkTreeViewColumn * treeview_column = gtk_tree_view_column_new_with_attributes(_("City"),
                                                                                 cell_renderer,
                                                                                 "text",
                                                                                 CITY_COLUMN,
                                                                                 NULL);

  gtk_tree_view_append_column(GTK_TREE_VIEW(treeview), treeview_column);

  /* state */
  cell_renderer = gtk_cell_renderer_text_new();
  /* This means a state, a county, a province, or similar. */
  treeview_column = gtk_tree_view_column_new_with_attributes(_("Region"),
                                                             cell_renderer,
                                                             "text",
                                                             STATE_COLUMN,
                                                             NULL);

  gtk_tree_view_append_column(GTK_TREE_VIEW(treeview), treeview_column);

  /* country */
  cell_renderer = gtk_cell_renderer_text_new();
  treeview_column = gtk_tree_view_column_new_with_attributes(_("Country"),
                                                             cell_renderer,
                                                             "text",
                                                             COUNTRY_COLUMN,
                                                             NULL);

  gtk_tree_view_append_column(GTK_TREE_VIEW(treeview), treeview_column);

  /* TreeView items */
  GtkListStore * list_store = gtk_list_store_new(MAX_COLUMNS, G_TYPE_STRING, G_TYPE_STRING, G_TYPE_STRING);

  GtkTreeIter iterator;

  guint length = g_list_length(list);

  guint index = 0;

  for (; index < length; ++index)
    {
      gtk_list_store_append(list_store, &iterator);

      LocationInfo * location = (LocationInfo *)g_list_nth_data(list, index);

      gtk_list_store_set(list_store, &iterator, 
                         CITY_COLUMN, location->pcCity_,
                         STATE_COLUMN, location->pcState_,
                         COUNTRY_COLUMN, location->pcCountry_, -1);
    }

  /* Set the model behind the tree view, and forget about it */
  gtk_tree_view_set_model(GTK_TREE_VIEW(treeview), GTK_TREE_MODEL(list_store));
  g_object_unref(list_store);

  GtkTreeSelection * selection = gtk_tree_view_get_selection(GTK_TREE_VIEW(treeview));

  gtk_tree_selection_set_mode(selection, GTK_SELECTION_BROWSE);

  /* Internals of the dialog window */
  GtkWidget * scrolled_window = gtk_scrolled_window_new(NULL, NULL);
  gtk_scrolled_window_set_policy(GTK_SCROLLED_WINDOW(scrolled_window),
                                 GTK_POLICY_AUTOMATIC,
                                 GTK_POLICY_AUTOMATIC);

  gtk_container_add(GTK_CONTAINER(scrolled_window), treeview);

  gtk_box_pack_start(GTK_BOX(gtk_dialog_get_content_area(GTK_DIALOG(dialog))), scrolled_window, TRUE, TRUE, 0);

  gtk_widget_show_all(dialog);

  gint response = gtk_dialog_run(GTK_DIALOG(dialog));

  GtkTreeModel * model;

  /* handle selection */
  switch(response)
    {
    case GTK_RESPONSE_ACCEPT:
      model = gtk_tree_view_get_model(GTK_TREE_VIEW(treeview));

      if (gtk_tree_selection_get_selected(selection, &model, &iterator))
        {
          /* Save the current location, if set... */
          if (priv->location)
            {
              copyLocation(&priv->previous_location, priv->location);
            }

          gchar * path = gtk_tree_model_get_string_from_iter(model, &iterator);

          gint index = (gint)g_ascii_strtoull(path, NULL, 10);

          LocationInfo * location = g_list_nth_data(list, index);

          /* new location contains no info on autoupdate, copy from current */
          if (location && priv->location)
            {
              location->bEnabled_ = priv->location->bEnabled_;
              location->uiInterval_ = priv->location->uiInterval_;
            }

          gtk_weather_set_location(weather, (gpointer)location);
          /* list of locations is released by the caller */

          /* preferences dialog is also repainted by caller */
          g_free(path);
        }
      
      break;

    default:
      break;
    }
  
  if (GTK_IS_WIDGET(dialog))
    {
      gtk_widget_destroy(dialog);
    }
  
  g_free(dialog_str);
}

/**
 * Generates the text for the tooltip based on current location and forecast.
 *
 * @param widget Pointer to the current instance of the weather widget.
 *
 * @return Text to be shown as part of the tooltip. The caller must release
 *         the memory using g_free.
 */
gchar *
gtk_weather_get_tooltip_text(GtkWeather * weather)
{
  GtkWeatherPrivate * priv = GTK_WEATHER_GET_PRIVATE(weather);

  LXW_LOG(LXW_DEBUG, "GtkWeather::get_tooltip_text()");

  gchar * tooltip_text = NULL;

  if (priv->location && priv->forecast)
    {
      LocationInfo * location = priv->location;
      ForecastInfo * forecast = priv->forecast;

      gchar * temperature = g_strdup_printf("%d \302\260%s",
                                            forecast->iTemperature_,
                                            forecast->units_.pcTemperature_);

#if 0 // TODO!
      gchar * today = g_strdup_printf("%s %d\302\260 / %d\302\260",
                                      forecast->today_.pcConditions_,
                                      forecast->today_.iLow_,
                                      forecast->today_.iHigh_);

      gchar * tomorrow = g_strdup_printf("%s %d\302\260 / %d\302\260",
                                         forecast->tomorrow_.pcConditions_,
                                         forecast->tomorrow_.iLow_,
                                         forecast->tomorrow_.iHigh_);
#endif
      /* make it nice and pretty */
      tooltip_text = g_strconcat(_("Currently in "),location->pcAlias_, ": ",
                                 forecast->pcClouds_ ? forecast->pcClouds_ : "",
                                 (forecast->pcConditions_ && forecast->pcClouds_) ? ", " : "",
                                 forecast->pcConditions_ ? forecast->pcConditions_ : "",
                                 ", ", temperature, "",
#if 0 // TODO!
                                 _("Today: "), today, "\n",
                                 _("Tomorrow: "), tomorrow,
#endif
                                 NULL);
                                 
      g_free(temperature);
#if 0 // TODO!
      g_free(today);
      g_free(tomorrow);
#endif

    }
  else if (priv->location)
    {
      tooltip_text = g_strdup_printf(_("Forecast for %s unavailable."),
                                     priv->location->pcAlias_);
    }
  else
    {
      tooltip_text = g_strdup_printf(_("Location not set."));
    }

  LXW_LOG(LXW_DEBUG, "\tReturning: %s", tooltip_text);

  return tooltip_text;
}

/**
 * Sets the icon on the specified window, if the icon id is found.
 *
 * @param window  Pointer to the GtkWindow to decorate.
 * @param icon_id The id of the icon to find.
 */
static void
gtk_weather_set_window_icon(GtkWindow * window, gchar * icon_id)
{
  LXW_LOG(LXW_DEBUG, "GtkWeather::set_window_icon(%s)", icon_id);

	if(gtk_icon_theme_has_icon(gtk_icon_theme_get_default(), icon_id))
    {
      GdkPixbuf* window_icon = gtk_icon_theme_load_icon(gtk_icon_theme_get_default(), 
                                                        icon_id,
                                                        24, 
                                                        0,
                                                        NULL);

      gtk_window_set_icon(window, window_icon);
    }

}

/**
 * Retrieves the forecast. Starts the forecast timer, if enabled in
 * the particular location.
 *
 * @param widget Pointer to the current instance of the weather widget
 */
static void
gtk_weather_get_forecast(GtkWeather * weather)
{
  LXW_LOG(LXW_DEBUG, "GtkWeather::get_forecast()");

  GtkWeatherPrivate * priv = GTK_WEATHER_GET_PRIVATE(weather);

  LocationInfo * location = priv->location;

  if (location && location->bEnabled_)
    {      
      /* just to be sure... */
      guint interval_in_seconds = 60 * ((location->uiInterval_) ? location->uiInterval_ : 60);

      if (priv->forecast_data.timerid > 0)
        {
          g_source_remove(priv->forecast_data.timerid);
        }

      /* start forecast thread here */
      priv->forecast_data.timerid = g_timeout_add_seconds(interval_in_seconds,
                                                          gtk_weather_get_forecast_timerfunc,
                                                          (gpointer)weather);
      
    }
  else
    {
      if (priv->forecast_data.timerid > 0)
        {
          g_source_remove(priv->forecast_data.timerid);

          priv->forecast_data.timerid = 0;
        }
    }

  /* One, single call just to get the latest forecast */
  if (location)
    {
      gtk_weather_get_forecast_timerfunc((gpointer)weather);
    }
}

/**
 * The location retrieval thread function.
 *
 * @param arg Pointer to argument data.
 *
 * @return Data based on thread completion.
 */
static void *
gtk_weather_get_location_threadfunc(void * arg)
{
  GtkWeatherPrivate * priv = (GtkWeatherPrivate *)arg;

  GList * list = priv->provider->getLocationInfo(priv->provider_instance,
                                                 priv->location_data.location);

  g_list_foreach(list, (GFunc)setLocationAlias, (gpointer)priv->location_data.location);

  return list;  
}

/**
 * The forecast retrieval timer function.
 *
 * @param data Pointer to user-data (instance of this widget).
 *
 * @return TRUE if the timer should be restarted, FALSE otherwise.
 */
static gboolean 
gtk_weather_get_forecast_timerfunc(gpointer data)
{
  GtkWeatherPrivate * priv = GTK_WEATHER_GET_PRIVATE(GTK_WEATHER(data));

  LXW_LOG(LXW_DEBUG, "GtkWeather::get_forecast_timerfunc(%d %d)", 
          (priv->location)?priv->location->bEnabled_:0,
          (priv->location)?priv->location->uiInterval_ * 60:0);

  if (!priv->location)
    {
      return FALSE;
    }

  priv->forecast = priv->provider->getForecastInfo(priv->provider_instance,
                                                   priv->location, priv->forecast);

  gtk_weather_set_forecast(GTK_WEATHER(data), priv->forecast);

  return priv->location->bEnabled_;
}