Frontend Submissions ma szereg funkcji, które mogą być używane programistycznie.
Uczyń użytkownika sprzedawcą
Frontend Submissions ma funkcję pomocniczą o nazwie make_user_vendor(), która robi dwie rzeczy naraz:
- czyni użytkownika sprzedawcą
- zmienia status nowego sprzedawcy na Zatwierdzony
EDD_FES()->vendors->make_user_vendor( $user_id );
Ważne: parametr ID użyty powyżej to identyfikator użytkownika WordPress.
Zmień status sprzedawcy
Sprzedawca może mieć trzy statusy:
- Zatwierdzony
- Oczekująca
- Zawieszony
Istnieją również dwie akcje, które można wykonać:
- Odwiesić
- Cofnąć
Wszystkie te operacje używają tej samej metody, ale statusy i akcje to różne rzeczy. Oto jak to działa.
Najpierw musisz utworzyć instancję obiektu Frontend Submissions, podobnie jak w jednym z poniższych przykładów:
// Example showing required input $vendor = new FES_Vendor( $_id_or_email = false, $by_user_id = false );
// using a vendor ID $vendor = new FES_Vendor( 14, false ); // using the email address associated with the vendor ID $vendor = new FES_Vendor( '[email protected]', true );
Następnie uruchamiasz metodę change_status() na tym obiekcie, podobnie jak w jednym z poniższych przykładów:
// Example showing required input $vendor->change_status( $new_status = '', $in_admin = false, $output = false );
Wejście $in_admin pozwala zadeklarować, czy ta akcja powinna być dozwolona w kontekście obszaru administracyjnego, czy poza nim. Możesz na przykład chcieć zezwolić na tę zmianę w obszarze administracyjnym, ale nie poza nim.
// Set a vendor to approved, inside the admin area, with no output $vendor->change_status( 'approved' ); // Set a vendor to pending, outside the admin area, with no output $vendor->change_status( 'pending', true ); // Set a vendor to suspended, outside the admin area, with no output $vendor->change_status( 'suspended', true, true );
Oprócz powyższych zmian statusu, możesz wykonać następujące akcje:
// Revoke a vendor, inside the admin area, with no output. // This will effectively make a user NOT a vendor, and remove all their products. $vendor->change_status( 'revoke' ); // Changes a user from suspended to approved. At this point identical to setting // a user to approved, but in the future may contain some additional features. $vendor->change_status( 'unsuspend' );
