2 // This file is part of the aMule Project.
4 // Copyright (c) 2004-2008 aMule Team ( admin@amule.org / http://www.amule.org )
5 // Original author: Emilio Sandoz
7 // Any parts of this program derived from the xMule, lMule or eMule project,
8 // or contributed by third-party developers are copyrighted by their
11 // This program is free software; you can redistribute it and/or modify
12 // it under the terms of the GNU General Public License as published by
13 // the Free Software Foundation; either version 2 of the License, or
14 // (at your option) any later version.
16 // This program is distributed in the hope that it will be useful,
17 // but WITHOUT ANY WARRANTY; without even the implied warranty of
18 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 // GNU General Public License for more details.
21 // You should have received a copy of the GNU General Public License
22 // along with this program; if not, write to the Free Software
23 // Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
27 #include "PrefsUnifiedDlg.h"
29 #include <common/Constants.h>
31 #include <wx/colordlg.h>
32 #include <wx/tooltip.h>
34 #include "amule.h" // Needed for theApp
37 #include "EditServerListDlg.h"
38 #include "SharedFileList.h" // Needed for CSharedFileList
39 #include "StatisticsDlg.h" // Needed for graph parameters, colors
40 #include "IPFilter.h" // Needed for CIPFilter
41 #include "SearchList.h"
42 #include "ClientList.h"
43 #include "DirectoryTreeCtrl.h" // Needed for CDirectoryTreeCtrl
44 #include "Preferences.h"
45 #include "muuli_wdr.h"
47 #include <common/Format.h> // Needed for CFormat
48 #include "TransferWnd.h" // Needed for CTransferWnd::UpdateCatTabTitles()
49 #include "KadDlg.h" // Needed for CKadDlg
50 #include "OScopeCtrl.h" // Needed for OScopeCtrl
51 #include "ServerList.h"
52 #include "UserEvents.h"
54 BEGIN_EVENT_TABLE(PrefsUnifiedDlg
,wxDialog
)
56 #define USEREVENTS_EVENT(ID, NAME, VARS) \
57 EVT_CHECKBOX(USEREVENTS_FIRST_ID + CUserEvents::ID * USEREVENTS_IDS_PER_EVENT + 1, PrefsUnifiedDlg::OnCheckBoxChange) \
58 EVT_CHECKBOX(USEREVENTS_FIRST_ID + CUserEvents::ID * USEREVENTS_IDS_PER_EVENT + 3, PrefsUnifiedDlg::OnCheckBoxChange)
59 USEREVENTS_EVENTLIST()
60 #undef USEREVENTS_EVENT
63 EVT_CHECKBOX(ID_PROXY_ENABLE_PROXY
, PrefsUnifiedDlg::OnCheckBoxChange
)
64 EVT_CHECKBOX(ID_PROXY_ENABLE_PASSWORD
, PrefsUnifiedDlg::OnCheckBoxChange
)
65 // EVT_CHECKBOX(ID_PROXY_AUTO_SERVER_CONNECT_WITHOUT_PROXY, PrefsUnifiedDlg::OnCheckBoxChange)
68 EVT_SPINCTRL(IDC_PORT
, PrefsUnifiedDlg::OnTCPClientPortChange
)
70 // The rest. Organize it!
71 EVT_CHECKBOX(IDC_UDPDISABLE
, PrefsUnifiedDlg::OnCheckBoxChange
)
72 EVT_CHECKBOX(IDC_CHECKDISKSPACE
, PrefsUnifiedDlg::OnCheckBoxChange
)
73 EVT_CHECKBOX(IDC_USESKINFILES
, PrefsUnifiedDlg::OnCheckBoxChange
)
74 EVT_CHECKBOX(IDC_ONLINESIG
, PrefsUnifiedDlg::OnCheckBoxChange
)
75 EVT_CHECKBOX(IDC_REMOVEDEAD
, PrefsUnifiedDlg::OnCheckBoxChange
)
76 EVT_CHECKBOX(IDC_AUTOSERVER
, PrefsUnifiedDlg::OnCheckBoxChange
)
77 EVT_CHECKBOX(IDC_AUTOIPFILTER
, PrefsUnifiedDlg::OnCheckBoxChange
)
78 EVT_CHECKBOX(IDC_MSGFILTER
, PrefsUnifiedDlg::OnCheckBoxChange
)
79 EVT_CHECKBOX(IDC_MSGFILTER_ALL
, PrefsUnifiedDlg::OnCheckBoxChange
)
80 EVT_CHECKBOX(IDC_MSGFILTER_WORD
, PrefsUnifiedDlg::OnCheckBoxChange
)
81 EVT_CHECKBOX(IDC_FILTERCOMMENTS
, PrefsUnifiedDlg::OnCheckBoxChange
)
82 EVT_CHECKBOX(IDC_STARTNEXTFILE
, PrefsUnifiedDlg::OnCheckBoxChange
)
83 EVT_CHECKBOX(IDC_ENABLETRAYICON
, PrefsUnifiedDlg::OnCheckBoxChange
)
84 EVT_CHECKBOX(IDC_VERTTOOLBAR
, PrefsUnifiedDlg::OnCheckBoxChange
)
85 EVT_CHECKBOX(IDC_SUPPORT_PO
, PrefsUnifiedDlg::OnCheckBoxChange
)
86 EVT_CHECKBOX(IDC_ENABLE_PO_OUTGOING
, PrefsUnifiedDlg::OnCheckBoxChange
)
87 EVT_CHECKBOX(IDC_ENFORCE_PO_INCOMING
, PrefsUnifiedDlg::OnCheckBoxChange
)
89 EVT_BUTTON(ID_PREFS_OK_TOP
, PrefsUnifiedDlg::OnOk
)
90 EVT_BUTTON(ID_PREFS_CANCEL_TOP
, PrefsUnifiedDlg::OnCancel
)
93 // EVT_BUTTON(IDC_SELSKIN, PrefsUnifiedDlg::OnButtonDir)
94 EVT_BUTTON(IDC_BROWSEV
, PrefsUnifiedDlg::OnButtonBrowseApplication
)
95 EVT_BUTTON(IDC_SELTEMPDIR
, PrefsUnifiedDlg::OnButtonDir
)
96 EVT_BUTTON(IDC_SELINCDIR
, PrefsUnifiedDlg::OnButtonDir
)
97 EVT_BUTTON(IDC_SELOSDIR
, PrefsUnifiedDlg::OnButtonDir
)
98 EVT_BUTTON(IDC_SELBROWSER
, PrefsUnifiedDlg::OnButtonBrowseApplication
)
100 EVT_SPINCTRL(IDC_TOOLTIPDELAY
, PrefsUnifiedDlg::OnToolTipDelayChange
)
102 EVT_BUTTON(IDC_EDITADR
, PrefsUnifiedDlg::OnButtonEditAddr
)
103 EVT_BUTTON(IDC_IPFRELOAD
, PrefsUnifiedDlg::OnButtonIPFilterReload
)
104 EVT_BUTTON(IDC_COLOR_BUTTON
, PrefsUnifiedDlg::OnButtonColorChange
)
105 EVT_BUTTON(IDC_IPFILTERUPDATE
, PrefsUnifiedDlg::OnButtonIPFilterUpdate
)
106 EVT_CHOICE(IDC_COLORSELECTOR
, PrefsUnifiedDlg::OnColorCategorySelected
)
107 EVT_CHOICE(IDC_BROWSER
, PrefsUnifiedDlg::OnBrowserChange
)
108 EVT_LIST_ITEM_SELECTED(ID_PREFSLISTCTRL
,PrefsUnifiedDlg::OnPrefsPageChange
)
110 EVT_INIT_DIALOG(PrefsUnifiedDlg::OnInitDialog
)
112 EVT_COMMAND_SCROLL(IDC_SLIDER
, PrefsUnifiedDlg::OnScrollBarChange
)
113 EVT_COMMAND_SCROLL(IDC_SLIDER3
, PrefsUnifiedDlg::OnScrollBarChange
)
114 EVT_COMMAND_SCROLL(IDC_SLIDER4
, PrefsUnifiedDlg::OnScrollBarChange
)
115 EVT_COMMAND_SCROLL(IDC_SLIDER2
, PrefsUnifiedDlg::OnScrollBarChange
)
116 EVT_COMMAND_SCROLL(IDC_FILEBUFFERSIZE
, PrefsUnifiedDlg::OnScrollBarChange
)
117 EVT_COMMAND_SCROLL(IDC_QUEUESIZE
, PrefsUnifiedDlg::OnScrollBarChange
)
118 EVT_COMMAND_SCROLL(IDC_SERVERKEEPALIVE
, PrefsUnifiedDlg::OnScrollBarChange
)
120 EVT_SPINCTRL(IDC_MAXUP
, PrefsUnifiedDlg::OnRateLimitChanged
)
122 EVT_LIST_ITEM_SELECTED(IDC_EVENTLIST
, PrefsUnifiedDlg::OnUserEventSelected
)
124 EVT_CLOSE(PrefsUnifiedDlg::OnClose
)
130 * Creates an command-event for the given checkbox.
132 * This can be used enforce logical constraints by passing by
133 * sending a check-box event for each checkbox, when transfering
134 * to the UI. However, it should also be used for checkboxes that
135 * have no side-effects other than enabling/disabling other
136 * widgets in the preferences dialogs.
138 void SendCheckBoxEvent(wxWindow
* parent
, int id
)
140 wxCheckBox
* widget
= CastByID(id
, parent
, wxCheckBox
);
141 wxCHECK_RET(widget
, wxT("Invalid widget in CreateEvent"));
143 wxCommandEvent
evt(wxEVT_COMMAND_CHECKBOX_CLICKED
, id
);
144 evt
.SetInt(widget
->IsChecked() ? 1 : 0);
146 parent
->ProcessEvent(evt
);
152 * This struct provides a general way to represent config-tabs.
156 //! The title of the page, used on the listctrl.
158 //! Function pointer to the wxDesigner function creating the dialog.
159 wxSizer
* (*m_function
)(wxWindow
*, bool, bool );
160 //! The index of the image used on the list.
162 //! The actual widget. To be set later.
169 { wxTRANSLATE("General"), PreferencesGeneralTab
, 13, NULL
},
170 { wxTRANSLATE("Connection"), PreferencesConnectionTab
, 14, NULL
},
171 { wxTRANSLATE("Proxy"), PreferencesProxyTab
, 24, NULL
},
172 { wxTRANSLATE("Message Filter"), PreferencesMessagesTab
, 23, NULL
},
173 { wxTRANSLATE("Remote Controls"), PreferencesRemoteControlsTab
, 11, NULL
},
174 { wxTRANSLATE("Online Signature"), PreferencesOnlineSigTab
, 21, NULL
},
175 { wxTRANSLATE("Server"), PreferencesServerTab
, 15, NULL
},
176 { wxTRANSLATE("Files"), PreferencesFilesTab
, 16, NULL
},
177 { wxTRANSLATE("Directories"), PreferencesDirectoriesTab
, 17, NULL
},
178 { wxTRANSLATE("Statistics"), PreferencesStatisticsTab
, 10, NULL
},
179 { wxTRANSLATE("Security"), PreferencesSecurityTab
, 22, NULL
},
180 { wxTRANSLATE("Gui Tweaks"), PreferencesGuiTweaksTab
, 19, NULL
},
181 { wxTRANSLATE("Core Tweaks"), PreferencesaMuleTweaksTab
, 12, NULL
},
182 { wxTRANSLATE("Events"), PreferencesEventsTab
, 5, NULL
}
184 ,{ wxTRANSLATE("Debugging"), PreferencesDebug
, 25, NULL
}
189 PrefsUnifiedDlg::PrefsUnifiedDlg(wxWindow
*parent
)
191 wxDialog(parent
, -1, _("Preferences"),
192 wxDefaultPosition
, wxDefaultSize
,
193 wxDEFAULT_DIALOG_STYLE
|wxRESIZE_BORDER
)
195 preferencesDlgTop(this, false);
197 wxListCtrl
*PrefsIcons
= CastChild(ID_PREFSLISTCTRL
, wxListCtrl
);
198 wxImageList
*icon_list
= new wxImageList(16, 16);
199 PrefsIcons
->AssignImageList(icon_list
, wxIMAGE_LIST_SMALL
);
201 // Add the single column used
202 PrefsIcons
->InsertColumn(
203 0, wxEmptyString
, wxLIST_FORMAT_LEFT
,
204 PrefsIcons
->GetSize().GetWidth()-5);
206 // Temp variables for finding the smallest height and width needed
210 // Add each page to the page-list
211 for (unsigned int i
= 0; i
< itemsof(pages
); ++i
) {
212 // Add the icon and label assosiated with the page
213 icon_list
->Add(amuleSpecial(pages
[i
].m_imageidx
));
214 PrefsIcons
->InsertItem(i
, wxGetTranslation(pages
[i
].m_title
), i
);
217 // Set list-width so that there arn't any scrollers
218 PrefsIcons
->SetColumnWidth(0, wxLIST_AUTOSIZE
);
219 PrefsIcons
->SetMinSize(wxSize(PrefsIcons
->GetColumnWidth(0) + 10, -1));
220 PrefsIcons
->SetMaxSize(wxSize(PrefsIcons
->GetColumnWidth(0) + 10, -1));
222 // Now add the pages and calculate the minimum size
223 for (unsigned int i
= 0; i
< itemsof(pages
); ++i
) {
224 // Create a container widget and the contents of the page
225 pages
[i
].m_widget
= new wxPanel(this, -1);
226 pages
[i
].m_function(pages
[i
].m_widget
, true, true);
228 // Add it to the sizer
229 prefs_sizer
->Add(pages
[i
].m_widget
, 0, wxGROW
|wxEXPAND
);
231 if (pages
[i
].m_function
== PreferencesGeneralTab
) {
232 // This must be done now or pages won't Fit();
234 CastChild(IDC_BROWSERTABS
, wxCheckBox
)->Enable(false);
235 wxChoice
*browserCheck
= CastChild(IDC_BROWSER
, wxChoice
);
236 browserCheck
->Clear();
237 browserCheck
->Append(_("System default"));
238 browserCheck
->Append(_("User Defined"));
239 #endif /* __WXMSW__ */
240 } else if (pages
[i
].m_function
== PreferencesEventsTab
) {
242 #define USEREVENTS_REPLACE_VAR(VAR, DESC, CODE) + wxString(wxT("\n %") VAR wxT(" - ")) + wxGetTranslation(DESC)
243 #define USEREVENTS_EVENT(ID, NAME, VARS) case CUserEvents::ID: CreateEventPanels(idx, wxEmptyString VARS, pages[i].m_widget); break;
245 wxListCtrl
*list
= CastChild(IDC_EVENTLIST
, wxListCtrl
);
246 list
->InsertColumn(0, wxEmptyString
);
247 for (unsigned int idx
= 0; idx
< CUserEvents::GetCount(); ++idx
) {
248 long lidx
= list
->InsertItem(idx
,
249 wxGetTranslation(CUserEvents::GetDisplayName(
250 static_cast<enum CUserEvents::EventType
>(idx
))));
252 list
->SetItemData(lidx
,
253 USEREVENTS_FIRST_ID
+ idx
* USEREVENTS_IDS_PER_EVENT
);
255 USEREVENTS_EVENTLIST()
259 list
->SetColumnWidth(0, wxLIST_AUTOSIZE
);
262 else if (pages
[i
].m_function
== PreferencesDebug
) {
263 int count
= CLogger::GetDebugCategoryCount();
264 wxCheckListBox
* list
= CastChild( ID_DEBUGCATS
, wxCheckListBox
);
266 for ( int j
= 0; j
< count
; j
++ ) {
267 list
->Append( CLogger::GetDebugCategory( j
).GetName() );
272 // Align and resize the page
276 // Find the greatest sizes
277 wxSize size
= prefs_sizer
->GetSize();
278 if (size
.GetWidth() > width
) {
279 width
= size
.GetWidth();
282 if (size
.GetHeight() > height
) {
283 height
= size
.GetHeight();
287 prefs_sizer
->Detach(pages
[i
].m_widget
);
288 pages
[i
].m_widget
->Show(false);
291 // Default to the General tab
292 m_CurrentPanel
= pages
[0].m_widget
;
293 prefs_sizer
->Add(pages
[0].m_widget
, 0, wxGROW
|wxEXPAND
);
294 m_CurrentPanel
->Show( true );
296 // Select the first item
297 PrefsIcons
->SetItemState(0, wxLIST_STATE_SELECTED
, wxLIST_STATE_SELECTED
);
299 // We now have the needed minimum height and width
300 prefs_sizer
->SetMinSize(width
, height
);
302 // Store some often used pointers
303 m_ShareSelector
= CastChild(IDC_SHARESELECTOR
, CDirectoryTreeCtrl
);
304 m_buttonColor
= CastChild(IDC_COLOR_BUTTON
, wxButton
);
305 m_choiceColor
= CastChild(IDC_COLORSELECTOR
, wxChoice
);
307 // Connect the Cfgs with their widgets
308 thePrefs::CFGMap::iterator it
= thePrefs::s_CfgList
.begin();
309 for ( ; it
!= thePrefs::s_CfgList
.end(); ++it
) {
310 // Checking for failures
311 if ( !it
->second
->ConnectToWidget(it
->first
, this) ) {
312 printf("Failed to connect Cfg to widget with the ID %d and key %s\n",
313 it
->first
, (const char *)unicode2char(it
->second
->GetKey()));
318 // It must not be resized to something smaller than what it currently is
319 wxSize size
= GetClientSize();
320 SetSizeHints(size
.GetWidth(), size
.GetHeight());
323 FindWindow(IDC_VERTTOOLBAR
)->Enable(false);
328 Cfg_Base
* PrefsUnifiedDlg::GetCfg(int id
)
330 thePrefs::CFGMap::iterator it
= thePrefs::s_CfgList
.find( id
);
332 if ( it
!= thePrefs::s_CfgList
.end() ) {
340 bool PrefsUnifiedDlg::TransferToWindow()
342 // Connect the Cfgs with their widgets
343 thePrefs::CFGMap::iterator it
= thePrefs::s_CfgList
.begin();
344 for ( ; it
!= thePrefs::s_CfgList
.end(); ++it
) {
345 // Checking for failures
346 if ( !it
->second
->TransferToWindow() ) {
347 printf("Failed to transfer data from Cfg to Widget with the ID %d and key %s\n",
348 it
->first
, (const char *)unicode2char(it
->second
->GetKey()));
352 m_ShareSelector
->SetSharedDirectories(&theApp
->glob_prefs
->shareddir_list
);
354 for ( int i
= 0; i
< cntStatColors
; i
++ ) {
355 thePrefs::s_colors
[i
] = CStatisticsDlg::acrStat
[i
];
356 thePrefs::s_colors_ref
[i
] = CStatisticsDlg::acrStat
[i
];
361 OnTCPClientPortChange(e
);
363 // Proxy tab initialization
364 if (!CastChild(ID_PROXY_ENABLE_PROXY
, wxCheckBox
)->IsChecked()) {
365 FindWindow(ID_PROXY_TYPE
)->Enable(false);
366 FindWindow(ID_PROXY_NAME
)->Enable(false);
367 FindWindow(ID_PROXY_PORT
)->Enable(false);
369 if (!CastChild(ID_PROXY_ENABLE_PASSWORD
, wxCheckBox
)->IsChecked()) {
370 FindWindow(ID_PROXY_USER
)->Enable(false);
371 FindWindow(ID_PROXY_PASSWORD
)->Enable(false);
373 // This option from the proxy tab is currently unused
374 FindWindow(ID_PROXY_AUTO_SERVER_CONNECT_WITHOUT_PROXY
)->Enable(false);
376 // Enable/Disable some controls
378 CastChild(IDC_BROWSER
, wxChoice
)->GetSelection() ==
379 (int)CastChild(IDC_BROWSER
, wxChoice
)->GetCount() - 1;
380 FindWindow( IDC_BROWSERSELF
)->Enable( customBrowser
);
381 FindWindow( IDC_SELBROWSER
)->Enable( customBrowser
);
383 FindWindow( IDC_BROWSERTABS
)->Enable( !customBrowser
);
385 FindWindow( IDC_MINDISKSPACE
)->Enable( thePrefs::IsCheckDiskspaceEnabled() );
386 FindWindow( IDC_SKIN
)->Enable( thePrefs::UseSkins() );
387 FindWindow( IDC_OSDIR
)->Enable( thePrefs::IsOnlineSignatureEnabled() );
388 FindWindow( IDC_OSUPDATE
)->Enable( thePrefs::IsOnlineSignatureEnabled() );
389 FindWindow( IDC_UDPPORT
)->Enable( !thePrefs::s_UDPDisable
);
390 FindWindow( IDC_SERVERRETRIES
)->Enable( thePrefs::DeadServer() );
391 FindWindow( IDC_STARTNEXTFILE_SAME
)->Enable(thePrefs::StartNextFile());
394 FindWindow(IDC_ENABLETRAYICON
)->Enable(false);
395 FindWindow(IDC_MINTRAY
)->Enable(false);
397 FindWindow(IDC_MINTRAY
)->Enable(thePrefs::UseTrayIcon());
400 if (!CastChild(IDC_MSGFILTER
, wxCheckBox
)->IsChecked()) {
401 FindWindow(IDC_MSGFILTER_ALL
)->Enable(false);
402 FindWindow(IDC_MSGFILTER_NONSECURE
)->Enable(false);
403 FindWindow(IDC_MSGFILTER_NONFRIENDS
)->Enable(false);
404 FindWindow(IDC_MSGFILTER_WORD
)->Enable(false);
405 FindWindow(IDC_MSGWORD
)->Enable(false);
406 } else if (CastChild(IDC_MSGFILTER_ALL
, wxCheckBox
)->IsChecked()) {
407 FindWindow(IDC_MSGFILTER_NONSECURE
)->Enable(false);
408 FindWindow(IDC_MSGFILTER_NONFRIENDS
)->Enable(false);
409 FindWindow(IDC_MSGFILTER_WORD
)->Enable(false);
410 FindWindow(IDC_MSGWORD
)->Enable(false);
413 FindWindow(IDC_MSGWORD
)->Enable(CastChild(IDC_MSGFILTER_WORD
, wxCheckBox
)->IsChecked());
414 FindWindow(IDC_COMMENTWORD
)->Enable(CastChild(IDC_FILTERCOMMENTS
, wxCheckBox
)->IsChecked());
416 // Protocol obfuscation
417 ::SendCheckBoxEvent(this, IDC_SUPPORT_PO
);
418 ::SendCheckBoxEvent(this, IDC_ENABLE_PO_OUTGOING
);
419 ::SendCheckBoxEvent(this, IDC_ENFORCE_PO_INCOMING
);
422 // Set debugging toggles
423 int count
= CLogger::GetDebugCategoryCount();
424 wxCheckListBox
* list
= CastChild( ID_DEBUGCATS
, wxCheckListBox
);
426 for ( int i
= 0; i
< count
; i
++ ) {
427 list
->Check( i
, CLogger::GetDebugCategory( i
).IsEnabled() );
435 bool PrefsUnifiedDlg::TransferFromWindow()
437 // Connect the Cfgs with their widgets
438 thePrefs::CFGMap::iterator it
= thePrefs::s_CfgList
.begin();
439 for ( ; it
!= thePrefs::s_CfgList
.end(); ++it
) {
440 // Checking for failures
441 if ( !it
->second
->TransferFromWindow() ) {
442 printf("Failed to transfer data from Widget to Cfg with the ID %d and key %s\n",
443 it
->first
, (const char *)unicode2char(it
->second
->GetKey()));
447 theApp
->glob_prefs
->shareddir_list
.clear();
448 m_ShareSelector
->GetSharedDirectories(&theApp
->glob_prefs
->shareddir_list
);
450 for ( int i
= 0; i
< cntStatColors
; i
++ ) {
451 if ( thePrefs::s_colors
[i
] != thePrefs::s_colors_ref
[i
] ) {
452 CStatisticsDlg::acrStat
[i
] = thePrefs::s_colors
[i
];
453 theApp
->amuledlg
->m_statisticswnd
->ApplyStatsColor(i
);
456 theApp
->amuledlg
->m_kademliawnd
->SetGraphColors();
460 // Get debugging toggles
461 int count
= CLogger::GetDebugCategoryCount();
462 wxCheckListBox
* list
= CastChild( ID_DEBUGCATS
, wxCheckListBox
);
464 for ( int i
= 0; i
< count
; i
++ ) {
465 CLogger::SetEnabled( CLogger::GetDebugCategory( i
).GetType(), list
->IsChecked( i
) );
470 // Send preferences to core.
471 theApp
->glob_prefs
->SendToRemote();
478 bool PrefsUnifiedDlg::CfgChanged(int ID
)
480 Cfg_Base
* cfg
= GetCfg(ID
);
483 return cfg
->HasChanged();
490 void PrefsUnifiedDlg::OnOk(wxCommandEvent
& WXUNUSED(event
))
492 TransferFromWindow();
494 bool restart_needed
= false;
495 wxString restart_needed_msg
= _("aMule must be restarted to enable these changes:\n\n");
497 // do sanity checking, special processing, and user notifications here
498 thePrefs::CheckUlDlRatio();
500 if (CfgChanged(IDC_PORT
)) {
501 restart_needed
= true;
502 restart_needed_msg
+= _("- TCP port changed.\n");
505 if (CfgChanged(IDC_UDPPORT
)) {
506 restart_needed
= true;
507 restart_needed_msg
+= _("- UDP port changed.\n");
510 // Force port checking
511 thePrefs::SetPort(thePrefs::GetPort());
513 if ((CPath::GetFileSize(theApp
->ConfigDir
+ wxT("addresses.dat")) == 0) &&
514 CastChild(IDC_AUTOSERVER
, wxCheckBox
)->IsChecked() ) {
515 thePrefs::UnsetAutoServerStart();
516 wxMessageBox(wxString::wxString( _("Your Auto-update servers list is in blank.\n'Auto-update serverlist at startup' will be disabled.")),
517 _("Message"), wxOK
| wxICON_INFORMATION
, this);
520 if (thePrefs::AcceptExternalConnections() && thePrefs::ECPassword().IsEmpty()) {
521 thePrefs::EnableExternalConnections( false );
523 wxMessageBox( _("You have enabled external connections but have not specified a password.\nExternal connections cannot be enabled unless a valid password is specified."));
526 // save the preferences on ok
527 theApp
->glob_prefs
->Save();
529 if (CfgChanged(IDC_FED2KLH
) && theApp
->amuledlg
->GetActiveDialog() != CamuleDlg::DT_SEARCH_WND
) {
530 theApp
->amuledlg
->ShowED2KLinksHandler( thePrefs::GetFED2KLH() );
533 if (CfgChanged(IDC_LANGUAGE
)) {
534 restart_needed
= true;
535 restart_needed_msg
+= _("- Language changed.\n");
538 if (CfgChanged(IDC_TEMPFILES
)) {
539 restart_needed
= true;
540 restart_needed_msg
+= _("- Temp folder changed.\n");
543 if (CfgChanged(IDC_INCFILES
) || CfgChanged(IDC_TEMPFILES
) || m_ShareSelector
->HasChanged
) {
544 theApp
->sharedfiles
->Reload();
547 if (CfgChanged(IDC_OSDIR
) || CfgChanged(IDC_ONLINESIG
)) {
548 wxTextCtrl
* widget
= CastChild( IDC_OSDIR
, wxTextCtrl
);
550 // Build the filenames for the two OS files
551 theApp
->SetOSFiles( widget
->GetValue() );
554 if (CfgChanged(IDC_IPFCLIENTS
) || CfgChanged(IDC_IPFSERVERS
) || CfgChanged(ID_IPFILTERLEVEL
)) {
555 if (thePrefs::IsFilteringClients()) {
556 theApp
->clientlist
->FilterQueues();
558 if (thePrefs::IsFilteringServers()) {
559 theApp
->serverlist
->FilterServers();
563 if (thePrefs::GetShowRatesOnTitle()) {
564 // This avoids a 5 seconds delay to show the title
565 theApp
->amuledlg
->SetTitle(theApp
->m_FrameTitle
+ wxT(" -- ") + _("Up: 0.0 | Down: 0.0"));
567 // This resets the title
568 theApp
->amuledlg
->SetTitle(theApp
->m_FrameTitle
);
571 if (CfgChanged(IDC_EXTCATINFO
)) {
572 theApp
->amuledlg
->m_transferwnd
->UpdateCatTabTitles();
575 // Changes related to the statistics-dlg
576 if (CfgChanged(IDC_SLIDER
)) {
577 theApp
->amuledlg
->m_statisticswnd
->SetUpdatePeriod(thePrefs::GetTrafficOMeterInterval());
578 theApp
->amuledlg
->m_kademliawnd
->SetUpdatePeriod(thePrefs::GetTrafficOMeterInterval());
581 if ( CfgChanged(IDC_SLIDER3
) ) {
582 theApp
->amuledlg
->m_statisticswnd
->ResetAveragingTime();
585 if (CfgChanged(IDC_DOWNLOAD_CAP
)) {
586 theApp
->amuledlg
->m_statisticswnd
->SetARange( true, thePrefs::GetMaxGraphDownloadRate() );
589 if (CfgChanged(IDC_UPLOAD_CAP
)) {
590 theApp
->amuledlg
->m_statisticswnd
->SetARange( false, thePrefs::GetMaxGraphUploadRate() );
593 if (CfgChanged(IDC_SKIN
) || CfgChanged(IDC_USESKINFILES
)) {
594 theApp
->amuledlg
->Create_Toolbar(thePrefs::VerticalToolbar());
597 if (!thePrefs::GetNetworkED2K() && theApp
->IsConnectedED2K()) {
598 theApp
->DisconnectED2K();
601 if (!thePrefs::GetNetworkKademlia() && theApp
->IsConnectedKad()) {
605 if (!thePrefs::GetNetworkED2K() && !thePrefs::GetNetworkKademlia()) {
606 wxMessageBox(wxString::wxString(
607 _("Both ED2K and Kad network are disabled.\nYou won't be able to connect until you enable at least one of them.")));
610 if (thePrefs::GetNetworkKademlia() && thePrefs::IsUDPDisabled()) {
611 wxMessageBox(_("Kad will not start if your UDP port is disabled.\nEnable UDP port or disable Kad."),
612 _("Message"), wxOK
| wxICON_INFORMATION
, this);
615 if (restart_needed
) {
616 wxMessageBox(restart_needed_msg
+ _("\nYou MUST restart aMule now.\nIf you do not restart now, don't complain if anything bad happens.\n"), _("WARNING"),wxICON_EXCLAMATION
,this);
623 void PrefsUnifiedDlg::OnClose(wxCloseEvent
& event
)
627 // Try to keep the window alive when possible
628 if (event
.CanVeto()) {
631 if (theApp
->amuledlg
) {
632 theApp
->amuledlg
->m_prefsDialog
= NULL
;
635 // Un-Connect the Cfgs
636 thePrefs::CFGMap::iterator it
= thePrefs::s_CfgList
.begin();
637 for (; it
!= thePrefs::s_CfgList
.end(); ++it
) {
638 // Checking for failures
639 it
->second
->ConnectToWidget( 0 );
647 void PrefsUnifiedDlg::OnCancel(wxCommandEvent
& WXUNUSED(event
))
653 void PrefsUnifiedDlg::OnCheckBoxChange(wxCommandEvent
& event
)
655 bool value
= event
.IsChecked();
656 int id
= event
.GetId();
658 // Check if this checkbox is one of the User Events checkboxes
659 if (id
>= USEREVENTS_FIRST_ID
&&
660 id
< USEREVENTS_FIRST_ID
+
661 (int)CUserEvents::GetCount() * USEREVENTS_IDS_PER_EVENT
) {
662 // The corresponding text control always has
663 // an ID one greater than the checkbox
664 FindWindow(id
+ 1)->Enable(value
);
670 // UDP is disable rather than enable, so we flip the value
671 FindWindow( IDC_UDPPORT
)->Enable(!value
);
674 case IDC_CHECKDISKSPACE
:
675 FindWindow( IDC_MINDISKSPACE
)->Enable(value
);
678 case IDC_USESKINFILES
:
679 FindWindow( IDC_SKIN
)->Enable(value
);;
683 FindWindow( IDC_OSDIR
)->Enable(value
);;
684 FindWindow(IDC_OSUPDATE
)->Enable(value
);
688 FindWindow( IDC_SERVERRETRIES
)->Enable(value
);;
692 if ((CPath::GetFileSize(theApp
->ConfigDir
+ wxT("addresses.dat")) == 0) &&
693 CastChild(event
.GetId(), wxCheckBox
)->IsChecked() ) {
694 wxMessageBox(wxString::wxString( _("Your Auto-update servers list is in blank.\nPlease fill in at least one URL to point to a valid server.met file.\nClick on the button \"List\" by this checkbox to enter an URL.")),
695 _("Message"), wxOK
| wxICON_INFORMATION
);
696 CastChild(event
.GetId(), wxCheckBox
)->SetValue(false);
701 // Toogle All filter options
702 FindWindow(IDC_MSGFILTER_ALL
)->Enable(value
);
703 FindWindow(IDC_MSGFILTER_NONSECURE
)->Enable(value
);
704 FindWindow(IDC_MSGFILTER_NONFRIENDS
)->Enable(value
);
705 FindWindow(IDC_MSGFILTER_WORD
)->Enable(value
);
707 FindWindow(IDC_MSGWORD
)->Enable(
708 CastChild(IDC_MSGFILTER_WORD
, wxCheckBox
)->IsChecked());
710 FindWindow(IDC_MSGWORD
)->Enable(false);
714 case IDC_MSGFILTER_ALL
:
715 // Toogle filtering by data.
716 FindWindow(IDC_MSGFILTER_NONSECURE
)->Enable(!value
);
717 FindWindow(IDC_MSGFILTER_NONFRIENDS
)->Enable(!value
);
718 FindWindow(IDC_MSGFILTER_WORD
)->Enable(!value
);
720 FindWindow(IDC_MSGWORD
)->Enable(
721 CastChild(IDC_MSGFILTER_WORD
, wxCheckBox
)->IsChecked());
723 FindWindow(IDC_MSGWORD
)->Enable(false);
727 case IDC_MSGFILTER_WORD
:
728 // Toogle filter word list.
729 FindWindow(IDC_MSGWORD
)->Enable(value
);
732 case IDC_FILTERCOMMENTS
:
733 FindWindow(IDC_COMMENTWORD
)->Enable(value
);
736 case ID_PROXY_ENABLE_PROXY
:
737 FindWindow(ID_PROXY_TYPE
)->Enable(value
);
738 FindWindow(ID_PROXY_NAME
)->Enable(value
);
739 FindWindow(ID_PROXY_PORT
)->Enable(value
);
742 case ID_PROXY_ENABLE_PASSWORD
:
743 FindWindow(ID_PROXY_USER
)->Enable(value
);
744 FindWindow(ID_PROXY_PASSWORD
)->Enable(value
);
747 case IDC_STARTNEXTFILE
:
748 FindWindow(IDC_STARTNEXTFILE_SAME
)->Enable(value
);
751 case IDC_ENABLETRAYICON
:
752 FindWindow(IDC_MINTRAY
)->Enable(value
);
754 theApp
->amuledlg
->CreateSystray();
756 theApp
->amuledlg
->RemoveSystray();
758 thePrefs::SetUseTrayIcon(value
);
761 case ID_PROXY_AUTO_SERVER_CONNECT_WITHOUT_PROXY
:
763 case IDC_VERTTOOLBAR
:
764 theApp
->amuledlg
->Create_Toolbar(value
);
765 // Update the first tool (conn button)
766 theApp
->amuledlg
->ShowConnectionState();
769 case IDC_ENFORCE_PO_INCOMING
:
770 FindWindow(IDC_ENABLE_PO_OUTGOING
)->Enable(!value
);
773 case IDC_ENABLE_PO_OUTGOING
:
774 FindWindow(IDC_SUPPORT_PO
)->Enable(!value
);
775 FindWindow(IDC_ENFORCE_PO_INCOMING
)->Enable(value
);
779 FindWindow(IDC_ENABLE_PO_OUTGOING
)->Enable(value
);
788 void PrefsUnifiedDlg::OnButtonColorChange(wxCommandEvent
& WXUNUSED(event
))
790 int index
= m_choiceColor
->GetSelection();
791 wxColour col
= WxColourFromCr( thePrefs::s_colors
[index
] );
792 col
= wxGetColourFromUser( this, col
);
794 m_buttonColor
->SetBackgroundColour( col
);
795 thePrefs::s_colors
[index
] = CrFromWxColour(col
);
800 void PrefsUnifiedDlg::OnColorCategorySelected(wxCommandEvent
& WXUNUSED(evt
))
802 m_buttonColor
->SetBackgroundColour(
803 WxColourFromCr( thePrefs::s_colors
[ m_choiceColor
->GetSelection() ] ) );
807 void PrefsUnifiedDlg::OnBrowserChange( wxCommandEvent
& evt
)
809 wxTextCtrl
* textctrl
= CastChild( IDC_BROWSERSELF
, wxTextCtrl
);
810 wxButton
* btn
= CastChild( IDC_SELBROWSER
, wxButton
);
812 evt
.GetSelection() ==
813 (int)CastChild( IDC_BROWSER
, wxChoice
)->GetCount() - 1;
816 textctrl
->Enable( enable
);
819 btn
->Enable( enable
);
822 FindWindow( IDC_BROWSERTABS
)->Enable( !enable
);
827 void PrefsUnifiedDlg::OnButtonDir(wxCommandEvent
& event
)
832 switch ( event
.GetId() ) {
835 type
= _("Temporary files");
840 type
= _("Incoming files");
845 type
= _("Online Signatures");
850 // type = _("Skins directory");
858 type
= CFormat(_("Choose a folder for %s")) % type
;
859 wxTextCtrl
* widget
= CastChild( id
, wxTextCtrl
);
860 wxString dir
= widget
->GetValue();
861 wxString str
= wxDirSelector(
864 wxDefaultPosition
, this);
865 if (!str
.IsEmpty()) {
866 widget
->SetValue(str
);
871 void PrefsUnifiedDlg::OnButtonBrowseApplication(wxCommandEvent
& event
)
875 switch ( event
.GetId() ) {
877 id
= IDC_VIDEOPLAYER
;
878 title
= _("Browse for videoplayer");
881 id
= IDC_BROWSERSELF
;
882 title
= _("Select browser");
888 wxString wildcard
= CFormat(_("Executable%s"))
890 % wxT(" (*.exe)|*.exe");
895 wxString str
= wxFileSelector( title
, wxEmptyString
, wxEmptyString
,
896 wxEmptyString
, wildcard
, 0, this );
898 if ( !str
.IsEmpty() ) {
899 wxTextCtrl
* widget
= CastChild( id
, wxTextCtrl
);
900 widget
->SetValue( str
);
905 void PrefsUnifiedDlg::OnButtonEditAddr(wxCommandEvent
& WXUNUSED(evt
))
907 wxString
fullpath( theApp
->ConfigDir
+ wxT("addresses.dat") );
909 EditServerListDlg
* test
= new EditServerListDlg(this, _("Edit Serverlist"),
910 _("Add here URL's to download server.met files.\nOnly one url on each line."),
918 void PrefsUnifiedDlg::OnButtonIPFilterReload(wxCommandEvent
& WXUNUSED(event
))
920 theApp
->ipfilter
->Reload();
924 void PrefsUnifiedDlg::OnButtonIPFilterUpdate(wxCommandEvent
& WXUNUSED(event
))
926 theApp
->ipfilter
->Update( CastChild( IDC_IPFILTERURL
, wxTextCtrl
)->GetValue() );
930 void PrefsUnifiedDlg::OnPrefsPageChange(wxListEvent
& event
)
932 prefs_sizer
->Detach( m_CurrentPanel
);
933 m_CurrentPanel
->Show( false );
935 m_CurrentPanel
= pages
[ event
.GetIndex() ].m_widget
;
937 prefs_sizer
->Add( m_CurrentPanel
, 0, wxGROW
|wxEXPAND
);
938 m_CurrentPanel
->Show( true );
946 void PrefsUnifiedDlg::OnToolTipDelayChange(wxSpinEvent
& event
)
948 wxToolTip::SetDelay( event
.GetPosition() * 1000 );
952 void PrefsUnifiedDlg::OnInitDialog( wxInitDialogEvent
& WXUNUSED(evt
) )
954 // This function exists solely to avoid automatic transfer-to-widget calls
958 void PrefsUnifiedDlg::OnScrollBarChange( wxScrollEvent
& event
)
963 switch ( event
.GetId() ) {
966 label
= wxString::Format( wxPLURAL("Update delay: %d second", "Update delay: %d seconds", event
.GetPosition()), event
.GetPosition() );
967 theApp
->amuledlg
->m_statisticswnd
->SetUpdatePeriod(event
.GetPosition());
968 theApp
->amuledlg
->m_kademliawnd
->SetUpdatePeriod(event
.GetPosition());
972 id
= IDC_SLIDERINFO3
;
973 label
= wxString::Format( wxPLURAL("Time for average graph: %d minute", "Time for average graph: %d minutes", event
.GetPosition()), event
.GetPosition() );
974 theApp
->m_statistics
->SetAverageMinutes(event
.GetPosition());
978 id
= IDC_SLIDERINFO4
;
979 label
= wxString::Format( _("Connections Graph Scale: %d"), event
.GetPosition() );
980 theApp
->amuledlg
->m_statisticswnd
->GetConnScope()->SetRanges(0,event
.GetPosition());
984 id
= IDC_SLIDERINFO2
;
985 label
= wxString::Format( wxPLURAL("Update delay : %d second", "Update delay : %d seconds", event
.GetPosition()), event
.GetPosition() );
988 case IDC_FILEBUFFERSIZE
:
989 id
= IDC_FILEBUFFERSIZE_STATIC
;
990 // Yes, it seems odd to add the singular form here, but other languages might need to know the number to select the appropriate translation
991 label
= wxString::Format( wxPLURAL("File Buffer Size: %d byte", "File Buffer Size: %d bytes", event
.GetPosition() * 15000), event
.GetPosition() * 15000 );
995 id
= IDC_QUEUESIZE_STATIC
;
996 // Yes, it seems odd to add the singular form here, but other languages might need to know the number to select the appropriate translation
997 label
= wxString::Format( wxPLURAL("Upload Queue Size: %d client", "Upload Queue Size: %d clients", event
.GetPosition() * 100), event
.GetPosition() * 100 );
1000 case IDC_SERVERKEEPALIVE
:
1001 id
= IDC_SERVERKEEPALIVE_LABEL
;
1003 if ( event
.GetPosition() ) {
1004 label
= wxString::Format( wxPLURAL("Server connection refresh interval: %d minute", "Server connection refresh interval: %d minutes", event
.GetPosition()), event
.GetPosition() );
1006 label
= wxString::Format( _("Server connection refresh interval: Disabled") );
1014 wxStaticText
* widget
= CastChild( id
, wxStaticText
);
1017 widget
->SetLabel( label
);
1018 widget
->GetParent()->Layout();
1023 void PrefsUnifiedDlg::OnRateLimitChanged( wxSpinEvent
& event
)
1025 // Here we do immediate sainity checking of the up/down ratio,
1026 // so that the user can see if his choice is illegal
1028 // We only do checks if the rate is limited
1029 if ( event
.GetPosition() != (int)UNLIMITED
) {
1030 wxSpinCtrl
* dlrate
= CastChild( IDC_MAXDOWN
, wxSpinCtrl
);
1032 if ( event
.GetPosition() < 4 ) {
1033 if ( ( event
.GetPosition() * 3 < dlrate
->GetValue() ) ||
1034 ( dlrate
->GetValue() == (int)UNLIMITED
) ) {
1035 dlrate
->SetValue( event
.GetPosition() * 3 );
1037 } else if ( event
.GetPosition() < 10 ) {
1038 if ( ( event
.GetPosition() * 4 < dlrate
->GetValue() ) ||
1039 ( dlrate
->GetValue() == (int)UNLIMITED
) ) {
1040 dlrate
->SetValue( event
.GetPosition() * 4 );
1047 void PrefsUnifiedDlg::OnTCPClientPortChange(wxSpinEvent
& WXUNUSED(event
))
1049 int port
= CastChild(IDC_PORT
, wxSpinCtrl
)->GetValue();
1051 txt
<< wxT("UDP port for extended server requests (TCP+3):") << port
+ 3;
1052 CastChild(ID_TEXT_CLIENT_UDP_PORT
, wxStaticText
)->SetLabel(txt
);
1055 void PrefsUnifiedDlg::OnUserEventSelected(wxListEvent
& event
)
1057 for (unsigned int i
= 0; i
< CUserEvents::GetCount(); ++i
) {
1058 IDC_PREFS_EVENTS_PAGE
->Hide(i
+ 2);
1061 IDC_PREFS_EVENTS_PAGE
->Show((event
.GetData() - USEREVENTS_FIRST_ID
) / USEREVENTS_IDS_PER_EVENT
+ 2, true);
1063 IDC_PREFS_EVENTS_PAGE
->Layout();
1068 void PrefsUnifiedDlg::CreateEventPanels(const int idx
, const wxString
& vars
, wxWindow
* parent
)
1070 wxStaticBox
*item8
= new wxStaticBox( parent
, -1, CFormat(_("Execute command on `%s' event")) % wxGetTranslation(CUserEvents::GetDisplayName(static_cast<enum CUserEvents::EventType
>(idx
))) );
1071 wxStaticBoxSizer
*item7
= new wxStaticBoxSizer( item8
, wxVERTICAL
);
1073 wxCheckBox
*item9
= new wxCheckBox( parent
, USEREVENTS_FIRST_ID
+ idx
* USEREVENTS_IDS_PER_EVENT
+ 1, _("Enable command execution on core"), wxDefaultPosition
, wxDefaultSize
, 0 );
1074 item7
->Add( item9
, 0, wxALIGN_CENTER_VERTICAL
|wxLEFT
|wxRIGHT
, 5 );
1076 wxFlexGridSizer
*item10
= new wxFlexGridSizer( 3, 0, 0 );
1077 item10
->AddGrowableCol( 2 );
1079 item10
->Add( 20, 20, 0, wxALIGN_CENTER
|wxALL
, 0 );
1081 wxStaticText
*item11
= new wxStaticText( parent
, -1, _("Core command:"), wxDefaultPosition
, wxDefaultSize
, 0 );
1082 item10
->Add( item11
, 0, wxALIGN_CENTER
|wxALL
, 5 );
1084 wxTextCtrl
*item12
= new wxTextCtrl( parent
, USEREVENTS_FIRST_ID
+ idx
* USEREVENTS_IDS_PER_EVENT
+ 2, wxT(""), wxDefaultPosition
, wxDefaultSize
, 0 );
1085 item12
->Enable(CUserEvents::IsCoreCommandEnabled(static_cast<enum CUserEvents::EventType
>(idx
)));
1086 item10
->Add( item12
, 0, wxGROW
|wxALIGN_CENTER_VERTICAL
|wxALL
, 5 );
1088 item7
->Add( item10
, 0, wxGROW
|wxALIGN_CENTER_VERTICAL
|wxALL
, 0 );
1090 wxCheckBox
*item14
= new wxCheckBox( parent
, USEREVENTS_FIRST_ID
+ idx
* USEREVENTS_IDS_PER_EVENT
+ 3, _("Enable command execution on GUI"), wxDefaultPosition
, wxDefaultSize
, 0 );
1091 item7
->Add( item14
, 0, wxALIGN_CENTER_VERTICAL
|wxLEFT
|wxRIGHT
, 5 );
1093 wxFlexGridSizer
*item15
= new wxFlexGridSizer( 3, 0, 0 );
1094 item15
->AddGrowableCol( 2 );
1096 item15
->Add( 20, 20, 0, wxALIGN_CENTER
|wxALL
, 0 );
1098 wxStaticText
*item16
= new wxStaticText( parent
, -1, _("GUI command:"), wxDefaultPosition
, wxDefaultSize
, 0 );
1099 item15
->Add( item16
, 0, wxALIGN_CENTER
|wxALL
, 5 );
1101 wxTextCtrl
*item17
= new wxTextCtrl( parent
, USEREVENTS_FIRST_ID
+ idx
* USEREVENTS_IDS_PER_EVENT
+ 4, wxT(""), wxDefaultPosition
, wxDefaultSize
, 0 );
1102 item17
->Enable(CUserEvents::IsGUICommandEnabled(static_cast<enum CUserEvents::EventType
>(idx
)));
1103 item15
->Add( item17
, 0, wxGROW
|wxALIGN_CENTER_VERTICAL
|wxALL
, 5 );
1105 item7
->Add( item15
, 0, wxGROW
|wxALIGN_CENTER_VERTICAL
|wxALL
, 0 );
1107 wxStaticText
*item13
= new wxStaticText( parent
, -1, _("The following variables will be replaced:") + vars
, wxDefaultPosition
, wxDefaultSize
, 0 );
1108 item7
->Add( item13
, 0, wxGROW
|wxALIGN_CENTER_VERTICAL
|wxALL
, 5 );
1110 IDC_PREFS_EVENTS_PAGE
->Add(item7
, 0, wxGROW
|wxALIGN_CENTER_VERTICAL
|wxALL
, 5);
1112 IDC_PREFS_EVENTS_PAGE
->Layout();
1113 IDC_PREFS_EVENTS_PAGE
->Hide(idx
+ 2);
1115 // File_checked_for_headers