View source for Features/Proxy Settings

<noinclude>[[Category:Feature Ready for Release Manager]]
[[Category:Feature|Proxy Settings]]
</noinclude>

== Summary ==

Setting proxy parameters via special Control Panel component.

== Owner ==

* Code: [[User:alsroot|Aleksey Lim]]
* Icons: [[User:M_anish| Anish Mangal]]

== Current status ==

* Targeted release: 0.96
* Last updated: 2Tue Nov 22 20:40:01 UTC 2011
* Percentage of completion: 95%

== Detailed Description ==

In some cases people might be behind HTTP proxy. For now, there is no any users friendly way in Sugar to setup proxy setting.

== Benefit to Sugar ==

Set proxy parameters without using low level tools like gconftool or switching to Gnome session. This is especially required in Australia and is being developed by ActivityCentral following their input.

== Scope ==

New Control Panel component.

== UI Design ==

The Feature adds a new section to the Network Control Panel.

[[File:Proxy-section-1.png|center|600px|Upper part of the Network Control Panel]]
[[File:Proxy-section-2.png|center|600px|No proxy (direct connection)]]
[[File:Proxy-section-3.png|center|600px|Automatic proxy selection (WPAD)]]
[[File:Proxy-section-4.png|center|600px|Manual proxy settings (no authentication)]]
[[File:Proxy-section-5.png|center|600px|Manual proxy settings (with authentication)]]

For comparison, this is what the Gnome 3 proxy settings dialog looks like:

[[File:Gnome-3-proxy-settings.png|600px]]

== How To Test ==

* clone [http://git.sugarlabs.org/alsroot/proxy_cp sources]
* symlink cloned directory to CP components directory, {{Code|/usr/share/sugar/extensions/cpsection}} by default
* restart sugar shell
* open Proxy CP component and setup proxy connection
* open gnome-network-setting and check if it has the same options set

== User Experience ==

The feature is entirely localized only within Control Panel.

== Dependencies ==

None.

== Contingency Plan ==

Do not use new Control Panel component.

== Documentation ==

''Is there upstream documentation on this feature, or notes you have written yourself?  Has this topic been discussed in the mailing list or during a meeting? Link to that material here so other interested developers can get involved.''

== Release Notes ==
''The Sugar Release Notes inform end-users about what is new in the release. An Example is [[0.84/Notes]]. The release notes also help users know how to deal with platform changes such as ABIs/APIs, configuration or data file formats, or upgrade concerns.  If there are any such changes involved in this feature, indicate them here.  You can also link to upstream documentation if it satisfies this need.  This information forms the basis of the release notes edited by the release team and shipped with the release.''

== Comments and Discussion ==
* See [[{{TALKPAGENAME}}|discussion tab for this feature]] <!-- This adds a link to the "discussion" tab associated with your page.  This provides the ability to have ongoing comments or conversation without bogging down the main feature page. -->