DADA::Profile::Fields
NAME
DADA::Profile::Fields
SYNOPSIS
DESCRIPTION
Public Methods
new
my $pf = DADA::Profile::Fields->new
new
requires no parameters.
A DADA::Profile::Fields
object will be returned.
insert
$df->insert(
{
-email => 'user@example.com',
}
);
insert
inserts a new record into the profile table. This method requires a few parameters:
-email
is required and should hold a valid email address in the form of: user@example.com
-fields
holds the Profile Fields passed as a hashref. It is an optional parameter.
-mode
sets the way the new profile will be created and can either be set to, writeover
or, preserve
When set to, writeover
, any existing profile belonging to the email passed in the <-email> parameter will be clobbered.
When set to, preserve
, this method will first look and see if an already existing profile exists and if so, will not create a new one, but simply exit the method.
writeover
is the default, if no parameter is passed.
-confirmed
confirmed can also be passed with a value of either 1
or, 0
, with 1
being the default if the parameter is not passed.
Unconfirmed profiles are marked as existing, but not, "live" as a way to save the profile information, until the profile can be confirmed, by a user.
This method should return, 1
on success.
get
my $prof = $pf->get;
get
returns the Profile Fields for the email address passed in, -email
as a hashref.
-email
is a required parameter. Not passing it will cause this method to return, undef
.
Passing an email that doesn't have a profile saved will also return, undef
. Check before by using, exists()
-dotted
is an optional paramter, and will return the keys of the hashref appended with, subscriber.
exists
my $exists = $pf->exists(
{
-email => 'user@example.com',
}
);
exists
return either 1
, if the profile associated with the email address passed in the -email
parameter has a profile
or, 0
if there is no profile.
remove
$pf->remove(
{
-email => 'user@example.com',
}
);
remove
removes the Profile Fields assocaited with the email address passed in the -email
parameter.
remove
will return the number of rows removed - this should hopefully be only 1
. Any larger number would be a serious problem.
-email
is a required parameter. Not passing it will cause this method to return, undef
.
Passing an email that doesn't have a profile saved will also return, undef
. Check before by using, exists()
AUTHOR
Justin Simoni https://dadamailproject.com
LICENSE AND COPYRIGHT
Copyright (c) 1999 - 2023 Justin Simoni All rights reserved.
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., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.